home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 8 / QRZ Ham Radio Callsign Database - Volume 8.iso / pc / files / t_pa0gri / nos1229.nr < prev    next >
Text File  |  1996-06-25  |  167KB  |  4,238 lines
  1. .IZ
  2. .\" Format this manual with "nroff -ms nos_1229.nr" or "troff -ms nos_1229.nr"
  3. .nr LL 7.75i
  4. .\" Aug 5,1990
  5. .\" Original Phil Karn
  6. .\" Sep 8,1990
  7. .\" additions by Gerard van der Grinten, PA0GRI
  8. .\" Mar 3, 1991
  9. .\" additions by Bill Simpson
  10. .\" Jul 16, 1991
  11. .\" additions by Gerard van der Grinten, PA0GRI
  12. .ND August 1, 1992
  13. .sp 20
  14. .TL
  15. Network Operating System
  16. .ti 3
  17. User Reference Manual
  18. .AU
  19. Phil Karn, KA9Q
  20.     and
  21. Gerard van der Grinten, PA0GRI
  22. .sp 30
  23. This manual reflects version 911229 of NOS 2.0m
  24. as released to the public by PA0GRI
  25. .sp 16
  26. .nr HM 0.3i
  27. .nr FM 0.3i
  28. .NH 1
  29. The NOS.EXE Program
  30. .LP
  31. The MS-DOS executable file \fBNOS.EXE\fP
  32. (Further called \fBNos\fP) provides Internet (TCP/IP),
  33. NET/ROM and AX.25
  34. facilities.  Because it has an internal multitasking operating system,
  35. \fBNos\fP can act simultaneously as a client, a server and a packet switch
  36. for all three sets of protocols. That is, while a local user accesses remote
  37. services, the system can also provide those same services to remote users
  38. while also switching IP, NET/ROM and AX.25 packets and frames between other
  39. client and server nodes.
  40. .LP
  41. The keyboard and display is used by the local operator to control both host
  42. and gateway level functions, for which a number of commands are provided. 
  43. .NH 2
  44. Startup
  45. .LP
  46. nos [-b] [-s <#sockets>] [-d </directory>] [-v] [<startup file>]
  47. .LP
  48. When \fBNos\fP is executed without arguments, it attempts to open the file
  49. \fBautoexec.nos\fP in the root directory of the current drive.  If it
  50. exists, it is read and executed as though its contents were typed on the
  51. console as commands.  This feature is useful for attaching communication
  52. interfaces, configuring network addresses, and starting the various
  53. services.
  54. .LP
  55. Four command-line options are accepted:
  56. .NH 3
  57. -b
  58. .LP
  59. The \fB-b\fP option specifies the use of BIOS for console output;
  60. the default is to write directly to the video display buffer. Use
  61. this option if you are running under a windowing package and have
  62. trouble with output "bleeding through" on top of other windows.
  63. .NH 3
  64. -s <no_of_sockets>
  65. .LP
  66. The \fB-s\fP option specifies the size of the
  67. \fIsocket\fP array to be allocated within \fBNos\fP. This limits the number of
  68. network connections that may exist simultaneously; the default is 40.
  69. .NH 3
  70. -d </directory>
  71. .LP
  72. The \fB-d\fP option allows the user to specify a "root" directory for the
  73. configuration and spool files; it defaults to the root directory of the
  74. system.
  75. .NH 3
  76. -v
  77. .LP
  78. The \fB-v\fP option allows the user to view command execution during
  79. the startup of \fBNos\fP. It lets the commands read from \fBautoexec.nos\fP
  80. echo before they are executed. This is a nice help if \fBNos\fP stops (hangs)
  81. during initialization.
  82. .LP
  83. After all command line options, the name of a alternate startup file may
  84. be specified. This file is then opened and read instead
  85. of \fBautoexec.nos\fP.
  86. .bp
  87. .NH 2
  88. DOS environement variables.
  89. .LP
  90. The following DOS environement variables can be used to specify things
  91. to \fBNOS\fP.
  92. .NH 3
  93. TZ
  94. .LP
  95. The TZ variable should be set to the local timezone. Default is UTC.
  96. This is used on the timestamp in smtp.
  97. .NH 3
  98. MAILER
  99. .LP
  100. The MAILER specifies what program should be started when the \fBmail\fP
  101. command is entered. Default is BM.EXE.
  102. .NH 3
  103. COMSPEC
  104. .LP
  105. The COMSPEC specifies what command shell will be used to \fIshell out\fP
  106. of \fBNos\fP. This is normaly set by MS-DOS startup to COMMAND.COM.
  107. Default is also COMMAND.COM.
  108. .NH 3
  109. TMP
  110. .LP
  111. The TMP variable is used to create a spot where temporary files are created.
  112. Without TMP being set the temp files are created in the root directory.
  113. A sample is "set TMP=C:\\tmp\\".
  114. .NH 3
  115. USER
  116. .LP
  117. The USER variable is used by \fBftp\fP and \fBRlogin\fP to set the username
  118. for the rlogin daemon on the remote system. The default when not setting USER
  119. is guest.  Guess you don't like it, but that's life.
  120. With \fBftp\fP the user is suggested in the user name prompt. If a cr only
  121. is given the suggested name is used, otherwise the given name.
  122. .NH 1
  123. Console modes
  124. .LP
  125. The console may be in one of two modes: \fIcommand mode\fP and
  126. \fIconverse mode\fP.
  127. In \fIcommand mode\fP, the prompt \fBnet>\fP is displayed and any of the
  128. commands described in the \fBCommands\fP chapter may be entered.
  129. In \fIconverse mode\fP,
  130. keyboard input is processed according to the \fIcurrent session\fP.
  131. .LP
  132. Sessions come in many types: \fITelnet, Ttylink, Rlogin, FTP, AX25,
  133. Finger, Command, NETROM, Ping, More, Dial, Dir, PPP PAP,
  134. Hopcheck\fP and \fITip\fP.
  135. .LP
  136. In a Telnet, Ttylink, AX25, NETROM, Rlogin, or Tip
  137. session, keyboard input is sent to the
  138. remote system and any output from the remote system is displayed on the
  139. console.  In an FTP session, keyboard input is first examined to see if
  140. it is a known local command; if so it is executed locally.  If not, it
  141. is "passed through" to the remote FTP server.
  142. (See the \fBFTP Subcommands\fP chapter).
  143. In a Ping session the user may test the path to a
  144. remote site, in a More session, the user may examine a local
  145. file. A Hopcheck session is used to trace the path taken by packets
  146. to reach a specified destination. A Finger session is used to peek at a
  147. remote system for its users (and what they are doing on some extended
  148. responses from UNIX systems). PPP PAP is used as a link setup like slip
  149. between two systems.
  150. .LP
  151. The keyboard also has \fIcooked\fP and \fIraw\fP states.
  152. In \fIcooked\fP state, input
  153. is line-at-a-time; the user may use the line editing characters ^U, ^R,
  154. ^B, ^W and backspace to erase the line, redisplay the line, redisplay
  155. the remainder of the previous line, erase last word and erase the last
  156. character, respectively.
  157. Hitting either return or line feed passes the
  158. complete line up to the application.
  159. In \fIraw\fP mode, each character is
  160. immediately passed to the application as it is typed.
  161. The keyboard is always in \fIcooked\fP state in command mode.
  162. It is also \fIcooked\fP in converse mode on an AX25, FTP or NET/ROM session.
  163. In a Telnet or Ttylink session it depends on
  164. whether the remote end has issued (and the local end has
  165. accepted) the Telnet WILL ECHO option.  (See the \fBecho\fP command). 
  166. .LP
  167. On the IBM-PC, the user may escape back to \fIcommand mode\fP
  168. by hitting the F10 key or the \fIescape\fP key.
  169. On other systems, the user must enter the \fIescape\fP character, which is by
  170. default control-] (hex 1d, ASCII GS). (Note that this is distinct from the
  171. ASCII character of the same name). The escape character can be changed (see
  172. the \fBescape\fP command). The F10 key can be redefined with the fkey command
  173. so the user is now warned to leave one escape possibility open for himself.
  174. Setting both F10 and escape to unreachable codes renders a system unescapable
  175. and the user hung in a session.
  176. .LP
  177. In the IBM PC version, each session (including the command "session")
  178. has its own screen.
  179. When a new session is created,
  180. the command display is saved in memory and the screen is cleared.
  181. When the command escape key (usually F10 or ^]) is hit,
  182. the current session screen is saved and the command screen is restored.
  183. When a session is resumed,
  184. its screen is restored exactly as it appeared when it was last current.
  185. \fBNos\Fp expects that the driver NANSY.SYS is loaded to support the screen
  186. and terminal emulation routines. ANSY.SYS has many problems and should NOT
  187. been used. Version 24 of nansy.sys (nan24hyc.zip on download systems) should
  188. be used for best results. Users of DeskView should be ok with dvansy.sys as
  189. it has been reported that tab expansion is all right under DV.
  190. .NH 1
  191. Commands
  192. .LP
  193. This section describes the commands recognized in command mode,
  194. or within a startup file such as \fBautoexec.nos\fP.
  195. These are given in the following notation:
  196. .DS
  197. command
  198. command literal_parameter
  199. command subcommand <parameter>
  200. command [<optional_parameter>]
  201. command a | b
  202. .DE
  203. .LP
  204. Many commands take subcommands or parameters, which may be optional or
  205. required. In general, if a required subcommand or parameter is omitted,
  206. an error message will summarize the available subcommands or required
  207. parameters.  (Giving a '?' in place of the subcommand will also generate the
  208. message.  This is useful when the command word alone is a valid command.) If
  209. a command takes an optional value parameter, issuing the command without the
  210. parameter generally displays the current value of the variable. (Exceptions
  211. to this rule are noted in the individual command descriptions.)
  212. .LP
  213. Two or more parameters separated by vertical bar(s) denote a choice between
  214. the specified values.  Optional parameters are shown enclosed in [brackets],
  215. and a parameter enclosed in <angle brackets> should be replaced with an
  216. actual value or string.  For example, the notation \fB<hostid>\fP denotes an
  217. actual host or gateway, which may be specified in one of two ways:
  218. as a numeric IP address in dotted decimal notation (eg. 44.0.0.1.),
  219. or as a symbolic name listed in the file \fBdomain.txt\fP,
  220. .LP
  221. All commands and many subcommands may be abbreviated. You only need
  222. type enough of a command's name to distinguish it from others that
  223. begin with the same series of letters. Parameters, however, must be
  224. typed in full.
  225. .LP
  226. Certain FTP subcommands (eg. \fBput, get, dir\fP, etc) are recognized
  227. only in converse mode with the appropriate FTP session; they are not
  228. recognized in command mode.
  229. (See the \fBFTP Subcommands\fP chapter.)
  230. .NH 2
  231. <CR>
  232. .LP
  233. Entering a carriage return (empty line) while in command mode puts you in
  234. converse mode with the current session. If there is no current session,
  235. \fBNos\fP remains in command mode and reissues the \fBnet>\fP prompt.
  236. .NH 2
  237. !
  238. .LP
  239. An alias for the \fBshell\fP command.
  240. .NH 2
  241. #
  242. .LP
  243. Commands starting with the hash mark (#) are ignored. This is mainly useful
  244. for comments in the \fBautoexec.nos\fP file.
  245. .NH 2
  246. abort [<session #>]
  247. .LP
  248. Abort a FTP \fBget, put or dir\fP operation in progress. If issued without
  249. an argument, the current session is aborted. (This command works only
  250. on FTP sessions.) When receiving a file, \fBabort\fP
  251. simply resets the data connection; the next incoming data packet will generate
  252. a TCP RST (reset) response to clear the remote server.  When
  253. sending a file, \fBabort\fP sends a premature end-of-file. Note that in both
  254. cases \fBabort\fP will leave a partial copy of the file on the destination
  255. machine, which must be removed manually if it is unwanted.
  256. .NH 2
  257. arp
  258. .LP
  259. Display the Address Resolution Protocol table that maps IP addresses
  260. to their subnet (link) addresses on subnetworks capable of broadcasting.
  261. For each IP address entry the subnet type (eg. Ethernet, AX.25), subnet
  262. address and time to expiration is shown. If the link address is currently
  263. unknown, the number of IP datagrams awaiting resolution is also shown.
  264. .NH 3
  265. arp add <hostid> ether | ax25 | netrom | arcnet <ether_addr> | <ax25_addr>
  266. .LP
  267. Add a permanent entry to the table. It will not time out
  268. as will an automatically-created entry, but must be removed with the
  269. \fBarp drop\fP command. 
  270. .NH 3
  271. arp drop <hostid> ether | ax25 | netrom | arcnet
  272. .LP
  273. Delete a permanent entry from the arp table.
  274. .NH 3
  275. arp flush
  276. .LP
  277. Drop all automatically-created entries in the ARP table; permanent
  278. entries are not affected.
  279. .NH 3
  280. arp publish <hostid> ether | ax25 | netrom | arcnet <ether_addr> | <ax25_addr>
  281. .LP
  282. This command is similar to the \fBarp add\fP command, but the
  283. system will also respond to any ARP request it sees on the network that seeks
  284. the specified address.  (Use this feature with great care.)
  285. .NH 2
  286. autoroute <yes|no>
  287. .LP
  288. Displays or sets the IP autorouting option. When set all AX25 IP packets
  289. are analysed and remembered.
  290. .NH 2
  291. asystat
  292. .LP
  293. Display statistics on attached asynchronous communications interfaces
  294. (8250 or 16550A), if any. The display for each port consists of three
  295. lines. The first line gives the port label and the configuration flags;
  296. these indicate whether the port is a 16550A chip, the \fItrigger character\fP
  297. if any,
  298. whether CTS flow control is enabled,
  299. whether RLSD (carrier detect) line control is enabled,
  300. and the speed in bits per second.
  301. (Receiving the \fItrigger character\fP causes the driver
  302. to signal upper layer software that data is ready;
  303. it is automatically set to the appropriate frame end
  304. character for SLIP, PPP and NRS lines.)
  305. .LP
  306. The second line of the status display shows receiver (RX) event counts: the
  307. total number of receive interrupts, received characters, receiver overruns
  308. (lost characters) and the receiver \fIhigh water mark\fP.
  309. The high water mark is
  310. the maximum number of characters ever read from the device during a single
  311. interrupt. This is useful for monitoring system interrupt latency margins as
  312. it shows how close the port hardware has come to overflowing due to the
  313. inability of the CPU to respond to a receiver interrupt in time. 8250 chips
  314. have no FIFO, so the high water mark cannot go higher than 2 before overruns
  315. occur. The 16550A chip, however, has a 16-byte receive FIFO which the
  316. software programs to interrupt the CPU when the FIFO is one-quarter full.
  317. The high water mark should typically be 4 or 5 when a 16550A is used; higher
  318. values indicate that the CPU has at least once been slow to respond
  319. to a receiver interrupt.
  320. .LP
  321. When the 16550A is used, a count of FIFO timeouts is also displayed on the
  322. RX status line. These are generated automatically by the 16550A when three
  323. character intervals go by with more than 0 but less than 4 characters in the
  324. FIFO. Since the characters that make up a SLIP or NRS frame are normally
  325. sent at full line speed,
  326. this count will usually be a lower bound on the number of frames received
  327. on the port, as only the last fragment of a frame generally results
  328. in a timeout (and then only when the frame is not a multiple of 4 bytes
  329. long.)
  330. .LP
  331. Finally, the software fifo overruns and high water mark are displayed.
  332. These indicate whether the <bufsize> parameter on the attach command
  333. needs to be adjusted (see the \fBAttach Commands\fP chapter).
  334. .LP
  335. The third line shows transmit (TX) statistics,
  336. including a total count of transmit interrupts, transmitted characters,
  337. the length of the transmit queue in bytes,
  338. the number of status interrupts,
  339. and the number of THRE timeouts.
  340. The status interrupt count will be zero
  341. unless CTS flow control or RLSD line control has been enabled.
  342. The THRE timeout is a stopgap measure to catch lost transmit interrupts,
  343. which seem to happen when there is a lot of activity
  344. (ideally, this will be zero).
  345. .NH 2
  346. attach <hw type> ...
  347. .LP
  348. Configure and attach a hardware interface to the system. The details
  349. are highly interface dependent and dependent on configuration flags in the
  350. file config.h when the software is build. It can be that not all drivers
  351. listed below will be included in your copy of \fBNos\fP.
  352. Detailed instructions for each driver are in the \fBAttach Commands\fP chapter.
  353. Drivers are available for the following hardware types:
  354. .NH 3
  355. attach 3c500
  356. .LP
  357. Don't use this one anymore. Use the packet driver instead. This driver is
  358. obsolete and not supported anymore.
  359. .NH 3
  360. attach asy
  361. .LP
  362. Standard PC asynchronous interface (com port) using the National 8250
  363. or 16450 or 16550A chip or compatible equivalent.
  364. .NH 3
  365. attach axip
  366. .LP
  367. A "wormhole" ax25 digipeater device.
  368. .NH 3
  369. attach arcnet
  370. .LP
  371. A ARCnet driver via the PACKET driver.
  372. .NH 3
  373. attach drsi
  374. .LP
  375. N6TTO driver for the DRSI PCPA 8530 card.
  376. .NH 3
  377. attach eagle
  378. .LP
  379. WA3CVG/NG6Q driver for the Eagle Computer card (Zilog 8530).
  380. .NH 3
  381. attach hapn
  382. .LP
  383. KE3Z driver for the Hamilton Amateur Packet Network adapter board (Intel 8273).
  384. .NH 3
  385. attach hs
  386. .LP
  387. Special "high speed" 8530 driver for the WA4DSY 56kb/s modem.
  388. .NH 3
  389. attach kiss
  390. .LP
  391. This enables a multiplexed tnc type to be used for second channel. It is used
  392. to connect a second port to an already attached asy interface. It will copy
  393. most of the params of it's parent port.
  394. .NH 3
  395. attach netrom
  396. .LP
  397. This is a psuedo interface to enable NET/ROM operations.
  398. .NH 3
  399. attach packet
  400. .LP
  401. Driver for use with separate software "packet drivers" meeting the
  402. FTP Software, Inc, Software Packet Driver specification.
  403. .NH 3
  404. attach pc100
  405. .LP
  406. Driver for the PACCOMM PC-100 (Zilog 8530) card.
  407. .NH 3
  408. attach pi
  409. .LP
  410. Dma driven 8530 scc board from VE3IFB.
  411. .NH 3
  412. attach scc
  413. .LP
  414. PE1CHL driver for generic 8530 cards.
  415. .NH 3
  416. attach slfp
  417. .LP
  418. Serial Line Faming Protocol packet driver.
  419. .LP
  420. An easy way to obtain a summary of the parameters required for a given device
  421. is to issue a partial attach command (eg. \fBattach packet\fP.)
  422. This produces a usage message giving the complete command format.
  423. .NH 2
  424. attended [off | on]
  425. .LP
  426. Displays or sets the global "I am present" flag in \fBNos\fP. This flag is
  427. used in the welcome header by incoming ttylink connections.
  428. .NH 2
  429. ax25 <subcommand>
  430. .LP
  431. These commands are for Ax25 interfaces.
  432. .NH 3
  433. ax25 bc <interface> [on | off]
  434. .LP
  435. The bc command displays or enables or disables broadcasts via interface
  436. \fBinterface\fP when on | off are given.
  437. .NH 3
  438. ax25 bcinterval [<seconds>]
  439. .LP
  440. The bcinterval displays or sets the time in seconds between \fBbc\fP broadcasts.
  441. On display both the interval and the countdown values are shown.
  442. .NH 3
  443. ax25 bckick <interface>
  444. .LP
  445. The bckick command issues a direct broadcast to interface \fBinterface\fP when
  446. so enabled by a \fIax25 bc <interface> on\fP command.
  447. .NH 3
  448. ax25 bctext ["broadcast text"]
  449. .LP
  450. The bctext command displays or sets the text to be send for broadcast
  451. messages send out every \fBbcinterval\fP seconds.
  452. .NH 3
  453. ax25 blimit [<limit>]
  454. .LP
  455. Display or set the AX25 retransmission backoff limit. Normally each
  456. successive AX25 retransmission is delayed by twice the value of the
  457. previous interval; this is called \fIbinary exponential backoff\fP.
  458. When the backoff reaches the blimit setting it is held at that value,
  459. which defaults to 30.
  460. To prevent the possibility of "congestive collapse" on a loaded channel,
  461. blimit should be set at least as high as the number of stations sharing
  462. the channel.
  463. Note that this is applicable only on actual AX25 connections; UI frames
  464. will never be retransmitted by the AX25 layer.
  465. .NH 3
  466. ax25 dest
  467. .LP
  468. See ax25 hearddest command. This is a shorthand version of it.
  469. .NH 3
  470. ax25 digipeat [on | off]
  471. .LP
  472. Display or set the digipeater enable flag. If the axip interface is used
  473. this flag MUST be on , otherwise the digipeat function will not work at all.
  474. .NH 3
  475. ax25 filter <0 | 1 | 2 | 3>
  476. .LP
  477. The filter commands enables or disables the logging in the heard lists
  478. of source and destination ax25_addresses. This is a bitwise or function
  479. where the 01 value is for source stations and the 02 value for destination
  480. stations. When the bit is off , logging is enabled, when on disabeled.
  481. .NH 3
  482. ax25 flush
  483. .LP
  484. Clear the AX.25 "heard" list (see \fBax25 heard\fP).
  485. .NH 3
  486. ax25 heard [<interface>]
  487. .LP
  488. Display the AX.25 "heard" list. For each interface that is configured to
  489. use AX.25, a list of all ax25_addresses heard through that interface is
  490. shown, along with a count of the number of packets heard from each station
  491. and the interval, in hr:min:sec format, since each station was last heard.
  492. The local station always appears first in the listing; the packet count
  493. actually reflects the number of packets transmitted. This entry is always
  494. present even if no packets have been sent. If interface is given, only
  495. the heard list for that interface is displayed.
  496. Note that logging of heard stations is controlled with the \fBax25 filter\fP
  497. command.
  498. .NH 3
  499. ax25 hearddest [<interface>]
  500. .LP
  501. Displays the destination list, i.e. the addressed to stations. Next to the
  502. time the last transmission to that station the time that station replied
  503. (if heard) is displayed. This gives a good reference to see if a station
  504. is reachable and responding.
  505. .NH 3
  506. ax25 irtt [<milliseconds>]
  507. .LP
  508. Display or set the initial value of smoothed round trip time to be used
  509. when a new AX25 connection is created. The value is in milliseconds.
  510. The actual round trip time will be learned by measurement once the
  511. connection has been established.
  512. .NH 3
  513. ax25 kick <axcb>
  514. .LP
  515. Force a retransmission on the specified AX.25 control block.
  516. The control block address can be found with the \fBax25 status\fP command.
  517. .NH 3
  518. ax25 maxframe [<count>]
  519. .LP
  520. Establish the maximum number of frames that will be allowed to remain
  521. unacknowledged at one time on new AX.25 connections. This number cannot
  522. be greater than 7.
  523. Without \fBcount\fP it will display the current setting. Note that the maximum
  524. outstaning frame count only works with virtual connections. UI frames are
  525. not affected.
  526. .NH 3
  527. ax25 mycall [<ax25_addr>]
  528. .LP
  529. Display or set the default local AX.25 address.  The standard format is used,
  530. (eg. KA9Q-0 or WB6RQN-5).
  531. This command must be given before any \fBattach\fP commands
  532. using AX.25 mode are given.
  533. .NH 3
  534. ax25 paclen [<size>]
  535. .LP
  536. Limit the size of I-fields on new AX.25 connections.  If IP
  537. datagrams or fragments larger than this are transmitted, they will be
  538. transparently fragmented at the AX.25 level, sent as a series of I
  539. frames, and reassembled back into a complete IP datagram or fragment at
  540. the other end of the link. To have any effect on IP datagrams,
  541. this parameter should be less than or equal to
  542. the MTU of the associated interface.
  543. .NH 3
  544. ax25 pthresh [<size>]
  545. .LP
  546. Display or set the poll threshold to be used for new AX.25 Version 2
  547. connections.  The poll threshold controls retransmission behavior as
  548. follows. If the oldest unacknowledged I-frame size is less than the poll
  549. threshold, it will be sent with the poll (P) bit set if a timeout occurs.
  550. If the oldest unacked I-frame size is equal to or greater than the
  551. threshold, then a RR or RNR frame, as appropriate, with the poll bit set
  552. will be sent if a timeout occurs.
  553. .LP
  554. The idea behind the poll threshold is that the extra time needed to send a
  555. "small" I-frame instead of a supervisory frame when polling after a timeout
  556. is small, and since there's a good chance the I-frame will have to be sent
  557. anyway (i.e., if it were lost previously) then you might as well send it as
  558. the poll. But if the I-frame is large, send a supervisory (RR/RNR) poll
  559. instead to determine first if retransmitting the oldest unacknowledged
  560. I-frame is necessary; the timeout might have been caused by a lost
  561. acknowledgement.  This is obviously a tradeoff, so experiment with the
  562. poll threshold setting. The default is 128 bytes, one half the default
  563. value of \fBpaclen\fP.
  564. .NH 3
  565. ax25 reset <axcb>
  566. .LP
  567. Delete the AX.25 connection control block at the specified address.
  568. .NH 3
  569. ax25 retry [<count>]
  570. .LP
  571. Limit the number of successive unsuccessful retransmission attempts on
  572. new AX.25 connections. If this limit is exceeded, link re-establishment
  573. is attempted. If this fails \fBretry\fP times, then the connection
  574. is abandoned and all queued data is deleted.
  575. .NH 3
  576. ax25 route
  577. .LP
  578. Display the AX.25 routing table that
  579. specifies the digipeaters to be used in reaching a given station.
  580. .NH 4
  581. ax25 route add <target> [digis ... ]
  582. .LP
  583. Add an entry to the AX.25 routing table.  An automatic \fBax25
  584. route add\fP is executed if digipeaters are specified in an AX25 \fBconnect\fP
  585. command, or if a connection is received from a remote station via
  586. digipeaters. Such automatic routing table entries won't override locally
  587. created entries, however.
  588. .NH 4
  589. ax25 route drop <target>
  590. .LP
  591. Drop an entry for target from the AX.25 routing table.
  592. .NH 4
  593. ax25 route mode <target> [vc | datagram | interface]
  594. .LP
  595. Sets the mode to vc | datagram | interface for target. \fBInterface\fP is the 
  596. default for that interface. \fBVc\fP is a virtual circuit (ax25 connected mode)
  597. and \fBdatagram\fP is unconnected mode, (AX25 UI frames).
  598. .NH 3
  599. ax25 status [<axcb>]
  600. .LP
  601. Without an argument, display a one-line summary of each AX.25 control block.
  602. If the address of a particular control block is specified, the contents of
  603. that control block are dumped in more detail. Note that the send queue units
  604. are frames, while the receive queue units are bytes.
  605. .NH 3
  606. ax25 t3 [<milliseconds>]
  607. .LP
  608. Display or set the AX.25 idle "keep alive" timer. Value is in milliseconds.
  609. .NH 3
  610. ax25 t4 [<seconds>]
  611. .LP
  612. Display or set the AX.25 Link "redundancy" timer. Value is in seconds.
  613. When no exchange has been had during this time the link is reset and closed.
  614. .NH 3
  615. ax25 timertype [l | e | o]
  616. .LP
  617. Sets or displays the type of timer used for retransmission and recovery:
  618. \fBlinear, exponential\fP or \fBoriginal\fP.
  619. .NH 3
  620. ax25 version [1 | 2]
  621. .LP
  622. Display or set the version of the AX.25 protocol to attempt to use on
  623. new connections. The default is 1 (the version
  624. that does not use the poll/final bits).
  625. .NH 3
  626. ax25 window [<size>]
  627. .LP
  628. Set the number of bytes that can be pending on an AX.25 receive queue
  629. beyond which I frames will be answered with RNR (Receiver Not Ready)
  630. responses.  This presently applies only to suspended interactive AX.25
  631. sessions, since incoming I-frames containing network (IP, NET/ROM) packets
  632. are always processed immediately and are not placed on the receive queue.
  633. However, when an AX.25 connection carries both interactive
  634. and network packet traffic, an RNR generated because of
  635. backlogged interactive traffic will also stop network
  636. packet traffic from being sent.
  637. .NH 2
  638. bbs
  639. .LP
  640. Enter the local bbs port (same as a telnet session to your own station).
  641.  Current commands are:
  642.  help      ? <command>
  643.  area      a [<area>]
  644.  bye       b
  645.  connect   c <node>
  646.            c <interface> <ax25_addr> [[<ax25_addr>] .... ]
  647.  download  d <filename>
  648.            du <filename>         (for uuencode bin file)
  649.  escape    e [<escape char.]
  650.  finger    f [<user>]
  651.  help      h [<command>]
  652.  info      i
  653.  jheard    j
  654.  kill      k <msg number>
  655.  list      l [<msg number>]
  656.  mbusers   m 
  657.  nodes     n <node>
  658.  operator  o
  659.  ports     p
  660.  read      r [<msg number>]
  661.  send      s[f] <usename[@hostid] [<from_addr>] [$bul_id]
  662.  send repl sr [<mgs number>]
  663.  telnet    t <hostid>
  664.  upload    u <filename>
  665.  verbose   v <n>
  666.  what      w [<directory>]
  667.  expert    x
  668.  zap       z <filename>
  669.  sysop     @
  670. .NH 2
  671. bootp <subcommand>
  672. .LP
  673. This is a bootp server / client, included into \fBNos\fP. It is picked up
  674. from the University of Michigan in Ann Arbor. It is included into the
  675. sources of \fBNos\fP but is not used nor tested by me. (PA0GRI)
  676. Its usability is fague but the discussions on tcp-group drove me
  677. to include this for possible use of reusable addresses.
  678. .NH 3
  679. bootp start
  680. .LP
  681. Starts the bootp server.
  682. .NH 3
  683. bootp stop
  684. .LP
  685. Stops the bootp server.
  686. .NH 3
  687. bootp dns [<ipaddr>]
  688. .LP
  689. Display or set the list of domain name servers for \fBbootp\fP.
  690. .NH 3
  691. bootp dyip [<iface> | <iface> <ipaddr1> <ipaddr2> | <iface> off]
  692. .LP
  693. Display or set the interface address range. The range is between \fIipaddr1\fP
  694. and \fIipaddr2\fP, both in dot notation.
  695. .NH 3
  696. bootp host [<hostaddr> <hardware type> <hardware addr> <ip addr> [boot file]]
  697. .LP
  698. Display or activate a bootp process. \fIHardware type\fP is netrom, ether,
  699. macappletalk or ax25. \fIHardware addr\fP is the interface name. \fIIp addr\fP
  700. must be in dot notation.
  701. .NH 3
  702. bootp rmhost <ipaddr>
  703. .LP
  704. Delete \fIipaddr\fP from the host table.
  705. .NH 3
  706. bootp homedir [<directory> | default]
  707. .LP
  708. Display or set the directory where the \fBbootp\fP files reside. The default
  709. directory is bpfiles.
  710. .NH 3
  711. bootp defaultfile [<bootfile> | default]
  712. .LP
  713. Display or set the file name of the \fBbootp\fP file. The default is boot.
  714. .NH 3
  715. bootp logfile [<filename> | default] [on | off]
  716. .LP
  717. Starts or stops the logging of \fBbootp\fP requests to \fIfilename\fP or
  718. the default file name \fIbootplog\fP.
  719. .NH 3
  720. bootp logscreen [on | off]
  721. .LP
  722. Enables or disables the logging of \fBbootp\fP to the screen.
  723. .NH 2
  724. bootpd
  725. .LP
  726. This starts the server daemon for \fBbootp\fP.
  727. .NH 2
  728. cd [<dirname>]
  729. .LP
  730. Change the current working directory, and display the new setting.
  731. Without an argument, \fBcd\fP simply displays the current directory
  732. without change.
  733. The \fBpwd\fP command is an alias for \fBcd\fP.
  734. .NH 2
  735. close [<session>]
  736. .LP
  737. Close the specified session; without an argument, close the current session.
  738. On an AX.25 session, this command initiates a disconnect.  On a FTP or
  739. Telnet session, this command sends a FIN (i.e., initiates a close) on the
  740. session's TCP connection.  This is an alternative to asking the remote
  741. server to initiate a close (\fBQUIT\fP to FTP, or the logout command appropriate
  742. for the remote system in the case of Telnet).  When either FTP or Telnet
  743. sees the incoming half of a TCP connection close, it automatically responds
  744. by closing the outgoing half of the connection.  Close is more graceful than
  745. the \fBreset\fP command, in that it is less likely to leave the remote TCP in a
  746. "half-open" state.
  747. .NH 2
  748. cls
  749. .LP
  750. Clears the current session screen (command screen).
  751. .NH 2
  752. comm <interface> <text-string>
  753. .LP
  754. The \fBcomm\fP command sends \fBtext-string\fP via \fBinterface\fP.
  755. This can be used to send straight text to an tnc still in TAPR command mode
  756. during \fBNos\fP startup. Note that to preserve spaces tabs etc. to include
  757. the string between double quote characters. Aka: comm ax1 "start kiss"
  758. .NH 2
  759. connect <iface> <ax25_addr> [<digipeater> ... ]
  760. .LP
  761. Initiate a "vanilla" AX.25 session to the specified ax25_addr using the
  762. specified interface. Data sent on this session goes out in
  763. conventional AX.25 packets with no upper layer protocol.  The de-facto
  764. presentation standard format is used, in that each packet holds one line
  765. of text, terminated by a carriage return.  A single AX.25 connection may
  766. be used for terminal-to-terminal, IP and NET/ROM traffic.
  767. The three types of data being automatically separated by their
  768. AX.25 Level 3 Protocol IDs.
  769. .LP
  770. Up to 7 optional digipeaters may be given; note that the word \fBvia\fP is NOT
  771. needed. If digipeaters are specified, they are automatically added to the
  772. AX25 routing table as though the \fBax25 route add\fP command had been given
  773. before issuing the \fBconnect\fP command.
  774. .NH 2
  775. delete <filename>
  776. .LP
  777. The \fBfilename\fP is removed from the file system.
  778. .NH 2
  779. detach <iface>
  780. .LP
  781. Detach a previously attached interface from the system. All IP routing
  782. table entries referring to this interface are deleted, and forwarding
  783. references by any other interface to this interface are removed.
  784. .NH 2
  785. dialer <iface> [<file> [<seconds> [<pings> [<hostid>]]]]
  786. .LP
  787. Setup an autodialer session for the interface.
  788. Whenever the interface is idle for the interval in <seconds>,
  789. the autodialer will ping the <hostid>.
  790. If there is no answer after <pings> attempts,
  791. the autodialer will execute the special commands contained in the <dialer-file>.
  792. .LP
  793. If the interval in <seconds> is zero,
  794. a previous dialer command process will be removed.
  795. If the number of <pings> is zero,
  796. the <dialer-file> will be executed without pinging the <hostid>.
  797. .LP
  798. The file may have any valid name,
  799. and must be located in the configuration root directory
  800. (see the \fBInstallion\fP section).
  801. The commands in the file are described in the \fBDialer Subcommands\fP chapter.
  802.  Commands in \fBfile\fP are:
  803. .NH 3
  804. control <up | down>
  805. .LP
  806. .NH 3
  807. send <string> [<milliseconds>]
  808. .LP
  809. Sends \fBstring\fP to the interface. If \fBmilliseconds\fP is given, inter
  810. character timing is \fBmilliseconds\fP milliseconds.
  811. .NH 3
  812. speed <bps>
  813. .LP
  814. Displays or sets the current interface speed to \fBbps\fP baud.
  815. .NH 3
  816. status <up | down>
  817. .LP
  818. .NH 3
  819. wait <milliseconds> [<string> [speed]]
  820. .LP
  821. Wait the amount of \fBmilliseconds\fP. If \fBstring\fP is given, incoming
  822. characters from the interface are compared with \fBstring\fP. If an compare
  823. is found and \fBspeed\fP is the string speed, the next numbers read from
  824. the interface is the new baudrate used. This works like HAYES response
  825. CONNECT 9600. The wait command could habe been "wait 10000 CONNECT speed".
  826. This waits 10 seconds for the CONNECT response from the modem.
  827. .NH 2
  828. dir [<dirname>]
  829. .LP
  830. List the contents of the specified directory on the console. If no argument
  831. is given, the current directory is listed. Note that this command works
  832. by first listing the directory into a temporary file, and then creating
  833. a \fBmore\fP session to display it. After this completes, the temporary
  834. file is deleted.
  835. .NH 2
  836. disconnect [<session>]
  837. .LP
  838. An alias for the \fBclose\fP command (for the benefit of AX.25 users).
  839. .NH 2
  840. domain <subcommand>
  841. .LP
  842. The domain commands control and show the working of the name to internet
  843. address mapping software. \fBNOS\fP currently only has a client with a
  844. simple file reading local server. A real server is needed to service the
  845. community for their growing needs.
  846. .NH 3
  847. domain addserver <hostid>
  848. .LP
  849. Add a domain name server to the list of name servers.
  850. Note that, when this command is given in the \fBautoexec.nos\fP file
  851. the \fBip address\fP command should given be before this command is used.
  852. (If not, \fBNos\fP will not kow how to resolve the address, and
  853. an answer will never be recognized, or worse: just plain hangs the system.)
  854. .NH 3
  855. domain cache <subcommand>
  856. .LP
  857. Following commands work on the domain cache. These are resource records
  858. (see RFC 1033/1034) held in memory.
  859. .NH 4
  860. domain cache clean [<yes | no>]
  861. .LP
  862. Displays or sets the discard of expired resource records. Expired records
  863. have their timeout value decremented to zero. Normaly resource records get
  864. a default timeout value of 1800 seconds. After this time they are considered
  865. "old" and if referenced again the domain name resolver should be enquired
  866. again.
  867. When clean is off (the default), expired records will be retained;
  868. if no replacement can be obtained from another domain name server,
  869. these records will continue to be used.
  870. .LP
  871. When clean is on, expired records will be removed from the file
  872. whenever any new record is added to the file.
  873. .NH 4
  874. domain cache list
  875. .LP
  876. This command shows the current content of the in memory cache for resource
  877. records.
  878. .NH 4
  879. domain cache size [<size>]
  880. .LP
  881. Display or set the nominal maximum size of the local memory cache.
  882. The default is 20.
  883. .LP
  884. (Note: The cache may be temporarily larger when waiting for new records
  885. to be written to the \fBdomain.txt\fP file.)
  886. .NH 4
  887. domain cache wait [<seconds>]
  888. .LP
  889. Display or set the interval in seconds to wait for additional activity
  890. before updating the \fBdomain.txt\fP file.  The default is 300 seconds
  891. (5 minutes).
  892. .NH 3
  893. domain dropserver <hostid>
  894. .LP
  895. Remove a domain name server from the list of name servers.
  896. You are warned when you delete the last name server.
  897. .NH 3
  898. domain listservers
  899. .LP
  900. List the currently configured domain name servers, along with statistics
  901. on how many queries and replies have been exchanged with each one,
  902. response times, etc.
  903. .NH 3
  904. domain maxwait [<timeout>]
  905. .LP
  906. This sets a timeout value (1 to 255 seconds) to a query or domain name server.
  907. This is not set for a already defined server but will be used for a newly
  908. defined name server. Also the value is used for domain nslookups.
  909. Note that name servers can have (PC based) trouble finding records in an
  910. large database. The default is set to 30 seconds.
  911. .NH 3
  912. domain retry [<retries>]
  913. .LP
  914. The retry value (number) limits the number of queries send out to
  915. remote domain name resolvers before giving up and telling you that
  916. host xyzzy.ampr.org does not exist. The total time lost with a query
  917. is retries * timeout * number of domain servers defined.
  918. .NH 3
  919. domain suffix [<domain suffix> | none]
  920. .LP
  921. Display or specify the default domain name suffix to be appended to
  922. a host name when it contains no periods. For example, if the suffix is
  923. set to \fBampr.org.\fP and the user enters \fBtelnet ka9q\fP, the domain
  924. resolver will attempt to find \fBka9q.ampr.org.\fP. If the host name being
  925. sought contains one or more periods, however, the default suffix is NOT
  926. applied if the last part of the name is less than 5 characters and contains
  927. only letters; e.g.,
  928.  \fBtelnet foo.bar\fP would NOT be turned into \fBfoo.bar.ampr.org.\fP.
  929.  \fBtelnet foo.ka9q\fP will be turned into \fBfoo.ka9q.ampr.org.\fP.
  930. Note that a trailing dot (.) is required for the suffix.
  931. If the suffix is the string \fBnone\fP (without trailing period) the current
  932. suffix is cleared and forgotten.
  933. .NH 3
  934. domain trace [on | off]
  935. .LP
  936. Display or set the flag controlling the tracing of domain server
  937. requests and responses. Trace messages will be seen only if a domain name
  938. being sought is not found in the local cache file, \fBdomain.txt\fP.
  939. .NH 3
  940. domain translate [off | on]
  941. .LP
  942. Display or set the flag that controls the translation of ip adress in
  943. dot notation into symbolic names. The translation process makes heavely
  944. use of reverse domain name lookups. Do not set this flag unless you have
  945. a good and fast connection to a domain name server or have a fast 
  946. domain.txt handler and domain.txt contains all IN-ADDR.ARPA. records
  947. you ever wanted.
  948. .NH 3
  949. domain verbose [off | on]
  950. .LP
  951. Display or set the flag controlling the return of a full name (true) or
  952. only the first name (dot delimiter) (false). This is for IP address to
  953. name translation only.
  954. .NH 3
  955. domain xyzzy
  956. .LP
  957. This is (when spelled fully) a magic word to enable domain queries to outside
  958. domain servers when reading commands from the startup file. This should only
  959. be used by those who have reliable access to a domain name server.
  960. .NH 2
  961. drsistat
  962. .LP
  963. Shows the statistics for all configured drsi boards.
  964. .NH 2
  965. dump <hex-address | .> [decimal-range]
  966. .LP
  967. The dump command shows memory in hex and ascii. Hex-address is a 32 bit value
  968. for a PC split into page address and page offset. A splitting colon is not
  969. used nor accepted. If decimal-range is not given , 128 bytes are displayed.
  970. \fBdump .\fP displayes memory starting at the end of a previous dump command.
  971. .NH 2
  972. echo [accept | refuse]
  973. .LP
  974. Display or set the flag controlling client Telnet's response to a
  975. remote WILL ECHO offer.
  976. .LP
  977. The Telnet presentation protocol specifies that in the absence of a negotiated
  978. agreement to the contrary, neither end echoes data received from the other.
  979. In this mode, a Telnet client session echoes keyboard input locally and nothing
  980. is actually sent until a carriage return is typed. Local line editing is also
  981. performed: backspace deletes the last character typed, while control-U deletes
  982. the entire line.
  983. .LP
  984. When communicating from keyboard to keyboard the standard local echo mode is
  985. used, so the setting of this parameter has no effect. However, many
  986. timesharing systems (eg. UNIX) prefer to do their own echoing of typed input.
  987. (This makes screen editors work right, among other things). Such systems send
  988. a Telnet WILL ECHO offer immediately upon receiving an incoming Telnet
  989. connection request. If \fBecho accept\fP is in effect, a client Telnet
  990. session will
  991. automatically return a DO ECHO response. In this mode, local echoing and
  992. editing is turned off and each key stroke is sent immediately (subject to the
  993. Nagle tinygram algorithm in TCP).  While this mode is just fine across an
  994. Ethernet, it is clearly inefficient and painful across slow paths like packet
  995. radio channels. Specifying \fBecho refuse\fP causes an incoming WILL ECHO
  996. offer to be answered with a DONT ECHO; the client Telnet session remains
  997. in the local echo mode.  Sessions already in the remote echo mode are
  998. unaffected. (Note: Berkeley Unix has a bug in that it will still echo input
  999. even after the client has refused the WILL ECHO offer. To get around this
  1000. problem, enter the \fBstty -echo\fP command to the shell once you have
  1001. logged in.)
  1002. .NH 2
  1003. eol [unix | standard]
  1004. .LP
  1005. Display or set Telnet's end-of-line behavior when in remote echo mode.
  1006. In standard mode, each key is sent as-is. In unix mode, carriage returns
  1007. are translated to line feeds.  This command is not necessary with all UNIX
  1008. systems; use it only when you find that a particular system responds to
  1009. line feeds but not carriage returns.  Only SunOS release 3.2 seems to
  1010. exhibit this behavior; later releases are fixed.
  1011. .NH 2
  1012. escape [<char>]
  1013. .LP
  1014. Display or set the current command-mode escape character in hex.
  1015. On the PC, the escape character is default ^]. The alternate escape key is F10
  1016. unless F10 is redefined with \fBfkey\fP.
  1017. .NH 2
  1018. etherstat
  1019. .LP
  1020. Display 3-Com Ethernet controller statistics (if configured).
  1021. .NH 2
  1022. exit
  1023. .LP
  1024. Exit the \fInos\fP program and return to MS-DOS.
  1025. .NH 2
  1026. finger <user@hostid> | <@hostid>
  1027. .LP
  1028. Issue a network finger request for user \fBuser\fP at host \fBhostid\fP. This
  1029. creates a client session which may be interrupted, resumed, reset, etc,
  1030. just like a Telnet client session. If only \fB@hostid\fP is given, all
  1031. users on that host are identified.
  1032. .bp
  1033. .NH 2
  1034. fkey [<number> [<string>]]
  1035. .LP
  1036. Fkey displays or sets values for the programmable keys on the PC keyboard.
  1037. \fBfkey\fP alone gives a display of all remapable keys and their number.
  1038. \fBfkey number\fP displays the current value for that key.
  1039. \fPfkey number string\fP assigns string to that key. Control characters
  1040. can be created by prefixing then with an ^ character. A cr is ^M.
  1041. To insert an ^ in the string 2 ^'s next to each other are needed.
  1042. Following is the map of keys and their number. F1 is function key 1.
  1043. Sf1 is Shift function key 1. Cf1 is Control function key 1. Af1 is
  1044. Alt function key 1. Etc. The right most row is the numeric keypad.
  1045.  
  1046.     key number   key  number   key  number   key  number  key   number
  1047.     f1   59      sf1   84      cf1   94      af1  104     pgup   73
  1048.     f2   60      sf2   85      cf2   95      af2  105     pgdn   81
  1049.     f3   61      sf3   86      cf3   96      af3  106     home   71
  1050.     f4   62      sf4   87      cf4   97      af4  107     end    79
  1051.     f5   63      sf5   88      cf5   98      af5  108     arup   72
  1052.     f6   64      sf6   89      cf6   99      af6  109     ardn   80
  1053.     f7   65      sf7   90      cf7  100      af7  110     ar l   75
  1054.     f8   66      sf8   91      cf8  101      af8  111     ar r   77
  1055.     f9   67      sf9   92      cf9  102      af9  112     ins    82
  1056.     f10  68      sf10  93      cf10 103      af10 113     del    83
  1057. .br
  1058. The mapping is taken to look like a vt100 / ansi keyboard.
  1059. Currently assigned value strings for following keys:
  1060.     number  string     key
  1061.     59     "\033OP"   /* F1 */
  1062.     60     "\033OQ"   /* F2 */
  1063.     61     "\033OR"   /* F3 */
  1064.     62     "\033OS"   /* F4 */
  1065.     71     "\010"     /* home*/
  1066.     72     "\033[A"   /* up arrow*/
  1067.     73     "\025"     /* pgup */
  1068.     75     "\033[D"   /* left arrow */
  1069.     77     "\033[C"   /* right arrow */
  1070.     79     "\005"     /* end */
  1071.     80     "\033[B"   /* down arrow */
  1072.     81     "\012"     /* pgdn */
  1073.     82     "\001"     /* ins */
  1074.     83     "\0177"    /* del */
  1075.  
  1076. .bp
  1077. .NH 2
  1078. ftp <hostid>
  1079. .LP
  1080. Open an FTP control channel to the specified remote host and enter converse
  1081. mode on the new session.  Responses from the remote server are displayed
  1082. directly on the screen. See the\fBFTP Subcommands\fP chapter for descriptions
  1083. of the commands available in a FTP session.
  1084. .NH 2
  1085. ftype [ascii | binary | image | logical <size>]
  1086. .LP
  1087. This command displays or sets the default start file mode (ascii or binary)
  1088. for ftp transfers. If ftype binary or image is given the next ftp session
  1089. started will be in binary type. No binary command is needed once the session
  1090. is started. In case of logical, the "word" size is set to \fBsize\fP.
  1091. .NH 2
  1092. help
  1093. .LP
  1094. Display a brief summary of top-level commands.
  1095. .NH 2
  1096. hop <subcommands>
  1097. .LP
  1098. These commands are used to test the connectivity of the network.
  1099. .NH 3
  1100. hop check <hostid>
  1101. .LP
  1102. Initiate a \fIhopcheck\fP session to the specified host. This uses a series
  1103. of UDP "probe" packets with increasing IP TTL fields to determine the
  1104. sequence of gateways in the path to the specified destination. This
  1105. function is patterned after the UNIX \fBtraceroute\fP facility.
  1106. .LP
  1107. ICMP message tracing should be turned off before this command is
  1108. executed (see the \fBicmp trace\fP command).
  1109. .NH 3
  1110. hop maxttl [<hops>]
  1111. .LP
  1112. Display or set the maximum TTL value to be used in hop check sessions.
  1113. This effectively bounds the radius of the search.
  1114. .NH 3
  1115. hop maxwait [<seconds>]
  1116. .LP
  1117. Display or set the maximum interval, in seconds, that a hopcheck session
  1118. will wait for responses at each stage of the trace. The default is 5 seconds.
  1119. .NH 3
  1120. hop queries [<count>]
  1121. .LP
  1122. Display or set the number of UDP probes that will be sent at each stage
  1123. of the trace. The default is 3.
  1124. .NH 3
  1125. hop trace [on | off]
  1126. .LP
  1127. Display or set the flag that controls the display of additional information
  1128. during a hop check session.
  1129. .NH 2
  1130. hostname [<name>]
  1131. .LP
  1132. Display or set the local host's name. By convention this should be the same
  1133. as the host's primary domain name. This string
  1134. is used only in the greeting messages
  1135. of the various network servers;
  1136. note that it does NOT set the system's IP address.
  1137. .LP
  1138. If <name> is the same as an <iface> (see the \fBAttach commands\fP chapter),
  1139. this command will search for a CNAME domain resource record
  1140. which corresponds to the IP address of the <iface>.
  1141. .NH 2
  1142. hs
  1143. .LP
  1144. Display statistics about the HS high speed HDLC driver (if configured
  1145. and active).
  1146. .NH 2
  1147. icmp <subcommand>
  1148. .LP
  1149. These commands are used for the Internet Control Message Protocol service.
  1150. .NH 3
  1151. icmp echo [on | off]
  1152. .LP
  1153. Display or set the flag controlling
  1154. the asynchronous display of ICMP Echo Reply packets.
  1155. This flag must be on for one-shot pings to work (see the \fBping\fP command.)
  1156. .NH 3
  1157. icmp status
  1158. .LP
  1159. Display statistics about the
  1160. Internet Control Message Protocol (ICMP), including the number of ICMP
  1161. messages of each type sent or received.
  1162. .NH 3
  1163. icmp trace [on | off]
  1164. .LP
  1165. Display or set the flag controlling
  1166. the display of ICMP error messages. These informational
  1167. messages are generated by Internet routers in response to routing,
  1168. protocol or congestion problems. This option should be turned
  1169. off before using the \fBhop check\fP facility because it
  1170. relies on ICMP Time Exceeded messages, and the asynchronous
  1171. display of these messages will be mingled with \fBhop check\fP command output.
  1172. .NH 2
  1173. ifconfig
  1174. .LP
  1175. Display a list of interfaces, with a short status for each.
  1176. .NH 3
  1177. ifconfig [<iface> [[[ <subcommand> <param>] <subcommand> <param>] .... ]
  1178. .LP
  1179. When only iface is given, a extended interface status is displayed.
  1180. Multiple subcommand / parameter can be put on one line.
  1181. .NH 3
  1182. ifconfig <iface> broadcast <addr>
  1183. .LP
  1184. Set the broadcast address of interface iface to \fBaddr\fP.
  1185. \fBAddr\fP can eighter be an ax25_addr or an ether_addr, depending
  1186. on the interface type, with 1's in the host part of the address.
  1187. This is related to the \fBnetmask\fP sub-command.
  1188. See also the \fBarp\fP command.
  1189. .NH 3
  1190. ifconfig <iface> description ["description"]
  1191. .LP
  1192. This command sets the interface description to the string specified. If no
  1193. string is supplied, the current description is cleared. The description
  1194. is displayed with the \fBifconfig iface\fP command (no parameters)
  1195. and with the mailbox commands.
  1196. .NH 3
  1197. ifconfig <iface> encapsulation <slip | ax25 | ether | encap | ppp>
  1198. .LP
  1199. Sets the encapsulation for interface iface to slip / ax25 / ether / encap / ppp.
  1200. .NH 3
  1201. ifconfig <iface> forward <iface-2>
  1202. .LP
  1203. When a forward is defined, all output for interface \fBiface\fP is redirected to
  1204. the interface directed by \fBiface-2\fP.
  1205. To remove the forward, set <iface-2> to <iface>.
  1206. .NH 3
  1207. ifconfig <iface> ipaddress <addr>
  1208. .LP
  1209. Set the IP address to \fBaddr\fP for this interface. This might be nessesary
  1210. when a system acts as a gateway. Like an system with IP address 44.137.1.8
  1211. has an Internet access via its ethernet. The Internet IP address could be
  1212. 129.179.122.10. An \fBifconfig ec0 ipaddress 129.179.122.10\fP sets the
  1213. correct address for that interface. Now routing to that system will work.
  1214. (Note that the 44.x.x.x address is NOT connected to the Internet.)
  1215. See also the \fBhostname\fP and \fBip address\fP commands.
  1216. .NH 3
  1217. ifconfig <iface> linkaddress <hardware-dependant>
  1218. .LP
  1219. Set the hardware dependant address for this interface.
  1220. For AX.25 this can be the callsign, for ethernet a new ethernet address.
  1221. .NH 3
  1222. ifconfig <iface> mtu <param>
  1223. .LP
  1224. Set the maximum transfer unit to \fBparam\fP octeds (bytes).
  1225. See the \fBSetting ... MTU, MSS and Window\fP chapter for more information.
  1226. .NH 3
  1227. ifconfig <iface> netmask <address>
  1228. .LP
  1229. Set the sub-net mask for this interface.
  1230. The <address> takes the form of an IP address
  1231. with 1's in the network and subnet parts of the address,
  1232. and 0's in the host part of the address.
  1233. Sample: ifconfig ec0 netmask 0xffffff00  for a class C network (24 bits).
  1234. This is related to the \fBbroadcast\fP sub-command.
  1235. See also the \fBroute\fP command.
  1236. .NH 3
  1237. ifconfig <iface> rxbuf <size>
  1238. .LP
  1239. Set the receive buffer size.
  1240. .NH 2
  1241. info
  1242. .LP
  1243. \fBInfo\fP gives information about the version of \fBNos\fP currently
  1244. running and its buildin configuration. The configuration info is build
  1245. with defines in config.h in the source distribution. That way it
  1246. gives automatically correct configuration information.
  1247. .NH 2
  1248. ip <subcommand>
  1249. .LP
  1250. These commands are used for the Internet Protocol service.
  1251. .NH 3
  1252. ip access <permit|deny|delete> <dest addr>[/<bits>] <ifname> [lowport [higport]]
  1253. .LP
  1254. Set or display access control for IP routing functions. This command implements
  1255. router access functions to \fBNos\Fp. Permit enables dest-addr packets to be
  1256. routed via ifname. Deny disables those. If lowport is not given, all ports
  1257. are assumed. If only lowport is given, that port is only checked for permission
  1258. If lowport and highport are given, that is the range of ports permitted/denied.
  1259. Dest-addr can be the word all for all addresses possible.
  1260. Lowport can be the word none for all ports.
  1261. The ip access delete must match a previous defined permit or deny to be able
  1262. to delete that definition.
  1263. Some samples:
  1264.  ip access permit 44/8 ax0
  1265.  ip access deny all ax0 1 1023
  1266.  ip access permit all ax0
  1267. If no access list is created, all interfaces might carry all types. If an access
  1268. control is defined for an interface there must be an permit defined for that
  1269. interface to allow trafic. Thus an partial denyal without an permit is an
  1270. complete denyal.
  1271. .NH 3
  1272. ip address [<hostid>]
  1273. .LP
  1274. Display or set the default local IP address. This command must be given before
  1275. an \fBattach\fP command if it is to be used as the default IP address for
  1276. the interface.
  1277. .NH 3
  1278. ip rtimer [<seconds>]
  1279. .LP
  1280. Display or set the IP reassembly timeout. The default is 30 seconds.
  1281. \fBValue\fP is in seconds.
  1282. .NH 3
  1283. ip status
  1284. .LP
  1285. Display Internet Protocol (IP) statistics, such as total packet counts
  1286. and error counters of various types.
  1287. .NH 3
  1288. ip ttl [<hops>]
  1289. .LP
  1290. Display or set the default time-to-live value placed in each outgoing IP
  1291. datagram. This limits the number of switch hops the datagram will be allowed to
  1292. take. The idea is to bound the lifetime of the packet should it become caught
  1293. in a routing loop, so make the value slightly larger than the number of
  1294. hops across the network you expect to transit packets.
  1295. The default is set at compilation time to the official recommended value
  1296. for the Internet.
  1297. .NH 2
  1298. isat [on | off]
  1299. .LP
  1300. Display or set the AT flag.
  1301. Normaly this flag is set when an interface is
  1302. attached with an interrupt of 8 or higher. This is to signal that the second
  1303. interrupt controllerc in a AT also needs an return of interrupt signal.
  1304. If an AT type clock is in use, this command will allow
  1305. measurement of time in milliseconds, rather than clock ticks
  1306. (55 milliseconds per clock tick).
  1307. During I/O initialisation this flag is set if the monitor prom
  1308. has the standard byte 0xfc at address f000:fffe.
  1309. .NH 2
  1310. kick [<session>]
  1311. .LP
  1312. Kick all sockets associated with a session;
  1313. if no argument is given, kick the current session.
  1314. Performs the same function as the \fBax25 kick\fP and \fBtcp kick\fP commands,
  1315. but is easier to type.
  1316. .NH 2
  1317. lock [password <"password string">]
  1318. .LP
  1319. Locks the keyboard or defines a password string.
  1320. If \fBpassword\fP is given then <password> is saved as the unlock string.
  1321. If no parameters are supplied, the keyboard becomes locked when a password
  1322. was specified earlier. If the keyboard is locked, the password is requested.
  1323. If a correct password is supplied, the keyboard becomes unlocked.
  1324. The setting of the password and locking of the keyboard can only been done by
  1325. the system console keyboard or \fBautoexec.nos\fP startup file.
  1326. The password can not been shown.
  1327. .NH 2
  1328. log [stop | <filename>]
  1329. .LP
  1330. Display the current log filename or set the \fBfilename\fP for logging
  1331. server sessions. If \fBstop\fP is given as the argument,
  1332. logging is terminated (the servers themselves are unaffected).
  1333. If a file name is given as an argument, server session log
  1334. entries will be appended to it.
  1335. .NH 2
  1336. lzw [<subcommand>]
  1337. .LP
  1338. Lzw is the data compression capability on some sockets. This command set
  1339. defines or changes their definition. Normaly leave this set default.
  1340. .NH 3
  1341. lzw mode <fast|compact>
  1342. .LP
  1343. Displays or sets the compression methode used on data compression for specific
  1344. sockets. Currently SMTP can use compression.
  1345. .NH 3
  1346. lzw bits <number>
  1347. .LP
  1348. Displays or sets the number of bits used for the compression size. The more
  1349. bits defined the larger the table space needed. Range is 9 to 16.
  1350. .NH 2
  1351. mail
  1352. .LP
  1353. This command will start a shell escape command. The mailer used is
  1354. defined with the DOS environment variable MAILER, wich defaults to
  1355. \fBBM.EXE\fP.
  1356. .NH 2
  1357. mbox [<subcommand>]
  1358. .LP
  1359. Display the status of the mailbox server system (if configured).
  1360. .NH 3
  1361. mbox attend [yes | no]
  1362. .LP
  1363. Displays or sets the attended flag on. This is used to announce in the mailbox
  1364. if the station mannager is willing to attend his station (chat).
  1365. .NH 3
  1366. mbox expert <on|off>
  1367. .LP
  1368. Displays or set the level expected of a mailbox user. When set (s)he gets a 
  1369. short ( > ) prompt. When not set a long prompt is send with the first letter of
  1370. each mailbox command as prompt. The user can then set Xpert mode
  1371. to get the short prompt.
  1372. .NH 3
  1373. mbox fwdinfo ["forward info"]
  1374. .LP
  1375. Displays or sets the mailbox forward info to be included in the R: line for
  1376. forwarded BBS bulletins.
  1377. An empty string ("") as info clears the info field.
  1378. .DS I 0
  1379. .ft CW
  1380. Sample: netrom fwdinfo "HNLNET BBS"
  1381. .ft P
  1382. .DE
  1383. Will show '[HNLNET BBS]' in the R: line.
  1384. .NH 3
  1385. mbox haddress ["home-address"]
  1386. .LP
  1387. Displays or sets the home address field to be included in the R: line for
  1388. forwarded BBS bulletins.
  1389. An empty string ("") clears the field.
  1390. .DS I 0
  1391. .ft CW
  1392. Sample: netrom haddress "#CRV.OR.USA"
  1393. .ft P
  1394. .DE
  1395. Will show '@WG7J#CRV.OR.USA' in the R: line. (when ax mycall is WG7J)
  1396. .NH 3
  1397. mbox jumpstart <on|off>
  1398. .LP
  1399. Displays or sets the mailbox jumpstart code. When set and an "known" node
  1400. connects to the mailbox, no extra line needs to be send to activate the
  1401. mailbox but the prompt is send directly. Warning: When set, it takes a
  1402. while to hear all nodes and an AX25 connect could have an wrong start
  1403. as there is no wait for a level 3 protocol check. Especialy RSPF in
  1404. virtual mode could course serious problems.
  1405. .NH 3
  1406. mbox kick
  1407. .LP
  1408. To kick the mailbox back in activity after retry timeouts.
  1409. .NH 3
  1410. mbox maxmsg
  1411. .LP
  1412. To display or set the maximum number of messages per area when an notesfile
  1413. is shown to a user. This reserves lots of memory for every mailbox session.
  1414. .NH 3
  1415. mbox motd ["message string"]
  1416. .LP
  1417. Display ot set the mailbox welcoming Message Of The Day.
  1418. .NH 3
  1419. mbox nrid <on|off>
  1420. .LP
  1421. DIsplays or sets the Netrom id flag. When set the node id is displayed
  1422. on the prompt line.
  1423. .NH 3
  1424. mbox operator [<address>]
  1425. .LP
  1426. The operator command shows or sets an alternate address for the control
  1427. operator. When set and mbox attend is off or the user is "shelled out"
  1428. and an mbox user requests a Operator command, the ttylink session is
  1429. redirected to the address specified. Else it works as before that the
  1430. mbox user is notified with "Unattended". When the system pointed to by
  1431. address has also set its attended to off, then an Unattended is replied
  1432. with as well (but generated by the remote station). This is a "flaky"
  1433. way of having an attended unattended system.
  1434. .NH 3
  1435. mbox password <"password string">
  1436. .LP
  1437. Sets a password string to be presented to Sysops entering that mode in the
  1438. mailbox (using the @ command and having that priviledge set to their login
  1439. name/password in \fBf/ftpusers\fP). When a password is defined (max 30 characters) then (s)he is prompted with 5 numbers before letting her/him in.
  1440. The five numbers represent the 5 character locations in the string defined,
  1441. whereby the first character is number 0.
  1442. Multiple lines of 5 characters can be send to fool "snoopers".
  1443. The end of password sending is signaled with an empty line. If there was
  1444. a good response, sysop mode is entered.
  1445. The setting of the password can only been done by the system console or
  1446. \fBautoexec.nos\fP startup file. The password can not been shown.
  1447. .NH 3
  1448. mbox qth ["qth info"]
  1449. .DS I 0
  1450. .ft CW
  1451. Sample: netrom qth "Driebruggen, NL"
  1452. .ft P
  1453. .DE
  1454. .LP
  1455. Displays or sets the info for qth in the R: line for forwarded BBS messages.
  1456. .NH 3
  1457. mbox secure <yes|no>
  1458. .LP
  1459. Displays or sets the security option for mailbox gateway users. If set
  1460. users comming in via telnet to the bbs are not allowed to use the gateway.
  1461. If not set anybody can use the gateway. (Note: No check for Bozo's).
  1462. Also the mailbox send command is disabled except for ax25 and netrom connects.
  1463. .NH 3
  1464. mbox smtptoo <yes|no>
  1465. .LP
  1466. Displays or sets the flag to include SMTP headers in BBS messages. When set
  1467. SMTP headers are included in messages. When not set not included.
  1468. .NH 3
  1469. mbox status
  1470. .LP
  1471. An alias for just entering mbox on the prompt line.
  1472. .NH 3
  1473. mbox timer [<seconds>]
  1474. .LP
  1475. Display the current interval and time remainig or
  1476. set the mailbox forwarding timer.
  1477. .NH 3
  1478. mbox tiptimeout
  1479. .LP
  1480. Displays or sets the timeout value for tip connection timeout. After
  1481. \fBtimeout\fP seconds of no activity the connection is closed.
  1482. .NH 3
  1483. mbox trace [yes | no]
  1484. .LP
  1485. Displays or sets mailbox forward trace code flag. The trace is very minimal
  1486. but every one working on mailbox/forward code now has a common flag \fBMtrace\fP.
  1487. .NH 3
  1488. mbox utc <offset>
  1489. .LP
  1490. Displays or sets the offset you are according to ZULU time. Positive and
  1491. negative numbers are supported and full leap year and month calculation
  1492. are done. This is used by the mailbox forwarding to give a standard time
  1493. in the R: line.
  1494. .NH 3
  1495. mbox zipcode zip
  1496. .LP
  1497. Displays or sets the info for the zip field for R: line BBS header lines.
  1498. This field is max 7 characters long as released. For USA the zip is only
  1499. 6 numbers long. Netherlands has 4 figures a space and 2 letters. Guess
  1500. every PTT wants something they "invented" their own.
  1501. .DS I 0
  1502. .ft CW
  1503. Sample: netrom zip "3465 TJ"    or:  netrom zip 54551
  1504. .ft P
  1505. .DE
  1506. .NH 2
  1507. memory <subcommand>
  1508. .LP
  1509. These commands are used for memory allocation.
  1510. .NH 3
  1511. memory debug [on|off]
  1512. .LP
  1513. Displays or sets the memory allocator debug flag. If set debug information
  1514. is written to the log file containing most flags and parameters from
  1515. the memory allocation routines.
  1516. .NH 3
  1517. memory efficient [yes | no]
  1518. .LP
  1519. Displays or sets the search algorithm for buffer memory. When set the
  1520. search is always started from the beginning of the free list. This is slower
  1521. but keeps memory fragmentation to a minimum. When clear
  1522. search is started on the end, accounting for more memory fragmentation
  1523. but keeping speed. Roumers state that you should include this command as
  1524. the first line in \fBautoexec.nos\fP.
  1525. The current releases default sets efficient to yes.
  1526. .NH 3
  1527. memory freelist
  1528. .LP
  1529. Display the storage allocator free list. Each entry consists of a
  1530. starting address, in hex, and a size, in decimal bytes.
  1531. .NH 3
  1532. memory ibufsize [<size>]
  1533. .LP
  1534. Display or set the size of the buffers in the interrupt buffer pool.
  1535. The size should be set to the largest type of buffer plus a header size of 22.
  1536. For example: If your ax25 is the omly interface and a packet length of 256
  1537. is defined, the ibufsize should be 256 + 10 * 6 + 22. The 10 * 6 is the
  1538. ax25 header (source , destination and 8 digipeaters).
  1539. .NH 3
  1540. memory minheap [<number>]
  1541. .LP
  1542. Displays or sets the minimum heap size to be allocated before shell escaping
  1543. to DOS. This assures a free heap so that \fBNos\fP can run trough without
  1544. gettig short on memory for a while.
  1545. .NH 3
  1546. memory nibufs [<number>]
  1547. .LP
  1548. Display or set the number of interrupt buffer pool buffers.
  1549. If the number of buffers is set, the statistics in the \fBmemory status\fP
  1550. display are reset for number of interrupt buffer fails. The minimum available
  1551. value is set to the requested number of buffers.
  1552. A roule of thumb for the number of buffers is to watch the statistics and
  1553. keep a minimum of 2 free buffers. Increase or decrease as required.
  1554. .NH 3
  1555. memory sizes
  1556. .LP
  1557. Display a histogram of storage allocator request sizes. Each histogram
  1558. bin is a binary order of magnitude (i.e., a factor of 2).
  1559. .NH 3
  1560. memory status
  1561. .LP
  1562. Display a summary of storage allocator statistics. The first line
  1563. shows the base address of the heap, its total size, the amount of heap
  1564. memory available in bytes and as a percentage of the total heap size,
  1565. and the amount of memory left over (i.e., not placed on the heap at startup)
  1566. and therefore available for \fBshell\fP subcommands.
  1567. .LP
  1568. The second line shows the total number of calls to allocate and free blocks
  1569. of memory, the difference of these two values (i.e., the number of allocated
  1570. blocks outstanding), the number of allocation requests that were denied
  1571. due to lack of memory, and the number of calls to free() that attempted to
  1572. free garbage
  1573. (eg. by freeing the same block twice or freeing a garbled pointer).
  1574. .LP
  1575. The third line shows the garbage collection status.
  1576. Garbage collection is a separate process running every second. If memory
  1577. is "low" garbage collection routines are called in "Red alert" mode, else
  1578. in "Yellow alert".
  1579. .LP
  1580. The fourth line shows the number of calls to malloc and free that occurred
  1581. with interrupts off. In normal situations these values should be zero.
  1582. The fourth line shows statistics for the special pool of fixed-size buffers
  1583. used to satisfy requests for memory at interrupt time. The variables
  1584. shown are the number of buffers currently in the pool, their size, and
  1585. the number of requests that failed due to exhaustion of the pool.
  1586. .LP
  1587. The fifth line shows the current setting of the interrupt buffer pool,
  1588. its minimal value and the number of no buffers available.
  1589. These statistics are reset when a \fBmemory nibufs <number>\fP command
  1590. is given.
  1591. .NH 3
  1592. memory thresh [<size>]
  1593. .LP
  1594. Displays or sets the memory threshold size in bytes. If memory gets below
  1595. this value , no more new sessions are started or accepted.
  1596. .NH 2
  1597. mkdir <dirname>
  1598. .LP
  1599. Create a sub-directory in the current working directory.
  1600. .NH 2
  1601. mode <iface> [vc | datagram]
  1602. .LP
  1603. Control the default transmission mode on the specified AX.25 interface.
  1604. In \fBdatagram\fP mode, IP packets are encapsulated in AX.25 UI frames and
  1605. transmitted without any other link level mechanisms, such as connections
  1606. or acknowledgements.
  1607. .LP
  1608. In \fBvc\fP (virtual circuit) mode, IP packets are encapsulated in AX.25 I
  1609. frames and are acknowledged at the link level according to the AX.25
  1610. protocol.  Link level connections are opened if necessary.
  1611. .LP
  1612. In both modes, ARP is used to map IP to AX.25 addresses.  The defaults
  1613. can be overridden with the type-of-service (TOS) bits in the IP header.
  1614. Turning on the "reliability" bit causes I frames to be used, while
  1615. turning on the "low delay" bit uses UI frames.  (The effect of turning
  1616. on both bits is undefined and subject to change).
  1617. .LP
  1618. In both modes, IP-level fragmentation is done if the datagram is larger
  1619. than the interface  MTU.  In virtual circuit mode, however, the resulting
  1620. datagram (or fragments) is further fragmented at the AX.25 layer if it
  1621. (or they) are still larger than the AX.25 \fBpaclen\fP parameter. In AX.25
  1622. fragmentation, datagrams are broken into several I frames and reassembled
  1623. at the receiving end before being passed to IP. This is preferable to
  1624. IP fragmentation whenever possible because of decreased overhead (the IP
  1625. header isn't repeated in each fragment) and increased robustness (a
  1626. lost fragment is immediately retransmitted by the link layer).
  1627. .NH 2
  1628. more <file> [<file> ...]
  1629. .LP
  1630. Display the specified file(s) a screen at a time. To proceed to the next
  1631. screen, press the space bar; to cancel the display, hit the 'q' key.
  1632. A CR advances a line.
  1633. The \fBmore\fP command creates a session that you can suspend and resume
  1634. just like any other session.
  1635. .NH 2
  1636. motd [<"message of the day">]
  1637. .LP
  1638. Display the current message or sets the welcome message to the defined string.
  1639. .NH 2
  1640. multitask [on | off]
  1641. .LP
  1642. Displays or sets the multi task flag. If set \fBNos\fP continues to service
  1643. its interrupts and handling of normal operation when put in the background
  1644. by executing a shell escape. Some programs do not like to miss valuable
  1645. time taken away this way and weard results can happen. Clearing the
  1646. flag stops all activiity fron \fBNos\fP when put in the background.
  1647. .NH 2
  1648. netrom <subcommand>
  1649. .LP
  1650. .NH 3
  1651. netrom acktime [<milliseconds>]
  1652. .LP
  1653. Displays or sets the ack delay timer, similary to ax25 t2.
  1654. .NH 3
  1655. netrom alias <alias>
  1656. .LP
  1657. This sets the \fBnetrom\fP alias for this station. Other stations can connect
  1658. to the ax25 callsign and to the Netrom alias (when set). The alias is
  1659. broadcasted with a Netrom broadcast.
  1660. .NH 3
  1661. netrom bcnodes <iface>
  1662. .LP
  1663. Initiates an immediate broadcast of nodelist on \fBiface\fP.
  1664. .NH 3
  1665. netrom call <call>
  1666. .LP
  1667. Displays or sets the call to be used by the netrom interface. Note: this is a
  1668. shortcut for the "ifconfig netrom linkaddress call" command.
  1669. .NH 3
  1670. netrom connect <node>
  1671. .LP
  1672. Start a connection to \fBnode\fP.
  1673. .NH 3
  1674. netrom choketime [<milliseconds>]
  1675. .LP
  1676. Display or set the time breaking a send choke. Choke is the term netrom
  1677. uses for flow control conditions.
  1678. .NH 3
  1679. netrom derate [on | off]
  1680. .LP
  1681. Display or set automatic derating of netrom routes on link failure.
  1682. .NH 3
  1683. netrom interface <iface> <quality>
  1684. .LP
  1685. Define a netrom interface \fBiface\fP.
  1686. The quality can be between 1 and 255. For compatibility with other
  1687. implementations set this to 192 normaly. A check is made that the
  1688. interface is of type CL_AX25, meaning NETROM capable media.
  1689. Note: the alias is not specified on this line anymore. Use netrom alias command.
  1690. .NH 3
  1691. netrom irtt [<milliseconds>]
  1692. .LP
  1693. Display or set the initial round trip time.
  1694. .NH 3
  1695. netrom kick <&nrcb>
  1696. .LP
  1697. Give the control block a kick to get activity going again.
  1698. .NH 3
  1699. netrom load [<filename>]
  1700. .LP
  1701. When fully implemented reloads a saved netrom node list to continue from
  1702. where you left when you saved the list. All entry's read are time decremented
  1703. as if normal time just went on. If it took some time (\fBobsotimer\fP * x)
  1704. your list could be empty as they all timed out.
  1705. .NH 3
  1706. netrom minquality [<value>]
  1707. .LP
  1708. Display or set the minimum quality for recognizing a node entry.
  1709. Entry's below this value are not considered valuable for usage.
  1710. .NH 3
  1711. netrom nodefilter <subcommand>
  1712. .LP
  1713. Node filtering.
  1714. .NH 4
  1715. netrom nodefilter add <neighbor> <iface>
  1716. .LP
  1717. Allow \fBneighbor\fP to give us node updates.
  1718. .NH 4
  1719. netrom nodefilter drop <neighbor> <iface>
  1720. .LP
  1721. Disallow \fBneighbor\fP to give us node updates.
  1722. .NH 4
  1723. netrom nodefilter mode [none | accept | reject]
  1724. .LP
  1725. Display or set the initial filter schema. \fBNone\fP accepts all.
  1726. \fBAccept\fP,accepts only from nodes defined in \fBnetrom nodefilter add\fP lists.
  1727. \fBReject\fP,no accepts from nodes defined in \fBnetrom nodefilter add\fP lists.
  1728. .NH 3
  1729. netrom nodetimer [<seconds>]
  1730. .LP
  1731. Display or set the interval our node list is transmitted.
  1732. .NH 3
  1733. netrom obsotimer [<seconds>]
  1734. .LP
  1735. Display or set the time a node quality gets decremented.
  1736. .NH 3
  1737. netrom promiscious [off | on]
  1738. .LP
  1739. Enables nodes with a higher quality than defined with minquality.
  1740. If on, all nodes are received, independent od nodefilter.
  1741. .NH 3
  1742. netrom qlimit [<bytes>]
  1743. .LP
  1744. Display or set the maximum queue limit for chat. Similar to ax25 window.
  1745. .NH 3
  1746. netrom reset <&nrcb>
  1747. .LP
  1748. Remove the control block. You can find the control block with \fBsocket\fP.
  1749. .NH 3
  1750. netrom retries [<value>]
  1751. .LP
  1752. Display or set the maximum number of retries on connect, disconnect or data.
  1753. .NH 3
  1754. netrom route <subcommand>
  1755. .LP
  1756. Netrom routing commands.
  1757. .NH 4
  1758. netrom route add <alias> <destination> <iface> <quality> <neighbor>
  1759. .LP
  1760. Add a netrom route.
  1761. .NH 4
  1762. netrom route drop <destination> <neighbor> <iface>
  1763. .LP
  1764. Delete a netrom route.
  1765. .NH 4
  1766. netrom route info <destination>
  1767. .LP
  1768. Display the route it would take to get to \fBdestination\fP.
  1769. .NH 3
  1770. netrom status
  1771. .LP
  1772. Displays all netrom connections.
  1773. .NH 3
  1774. netrom save [<filename>]
  1775. .LP
  1776. When fully implemented, saves the current netrom node list in memory to
  1777. /netrom.sav or filename, if given.
  1778. .NH 3
  1779. netrom timertype [exponential | linear]
  1780. .LP
  1781. Displays or sets the type of backoff.
  1782. .NH 3
  1783. netrom ttl [<hops>]
  1784. .LP
  1785. Display or set the maximum number of hops a frame might hop before discarded,
  1786. if it did not reach its destination before.
  1787. .NH 3
  1788. netrom user [<username>]
  1789. .LP
  1790. Display or set our netrom user name. This is used on outgoing connects.
  1791. .NH 3
  1792. netrom verbose [off | on]
  1793. .LP
  1794. Display or set the verbose flag. If set all nodes known to us are transmitted
  1795. each time the \fBnodetimer\fP expires. If off, only your stations node ident
  1796. is send out.
  1797. .NH 3
  1798. netrom window [<frames>]
  1799. .LP
  1800. Display or set the size of the sliding window. This is the largest send and
  1801. receive window we might negotiate.
  1802. .NH 2
  1803. nntp <subcommand>
  1804. .LP
  1805. Network news transfer protocol has the following subcommands:
  1806. .NH 3
  1807. nntp addserver <nntpserver> <seconds> [<range>] [<groups>]
  1808. .LP
  1809. Add a nntp news server to quiry every \fBseconds\fP interval for new
  1810. articles specified by the nntp groups command. Range can be a limit in
  1811. time to query like \fInntp addserver someserver 600 22:00-23:00\fP,
  1812. to only query the server between 10 and 11pm.
  1813. Multiple nntp add can be used co concatenate groups (up to 512 bytes)
  1814. The interval \fBseconds\fP can be set to 0, so that normaly the nntp client
  1815. does not query the server regulary but an \fInntp kick nntpserver\fP can be
  1816. used to start a session.
  1817. .NH 3
  1818. nntp directory <directory>
  1819. .LP
  1820. Show or set default directory for spooling news.
  1821. This is not the control directory but the (alternate) place to spool
  1822. articles to.
  1823. .NH 3
  1824. nntp dropserver <nntpserver>
  1825. .LP
  1826. .NH 3
  1827. nntp groups <group> [<group> ...]
  1828. .LP
  1829. Set or display currently set newsgroups.
  1830. .NH 3
  1831. nntp  kick <nntpserver>
  1832. .LP
  1833. Kick the client to get in touch with the named server.
  1834. .NH 3
  1835. nntp listservers
  1836. .LP
  1837. Lists the curently defined servers.
  1838. .NH 2
  1839. nntp quiet [yes | no]
  1840. .LP
  1841. Shows or sets the flag controlling the display of newly received nntp
  1842. news messages. The smpt quiet fag controls the beep following the message.
  1843. If both are off, nothing is shown, keeping the display from getting hung
  1844. on -more- when running unattended.
  1845. .NH 2
  1846. nntp trace <level>
  1847. .LP
  1848. Sets or shows the current trace level for the nntp client.
  1849. 0 No tracing
  1850. 1 (default) displays serious errors.
  1851. 2  displays as 1 and transient errors.
  1852. 3  displays as 2 and session progress.
  1853. 4  displays as 3 and actual received articles.
  1854. 5  displays errors.
  1855. .NH 2
  1856. nrstat
  1857. .LP
  1858. Displays the netrom interface statistics.
  1859. .NH 2
  1860. param <iface> [<param> ...]
  1861. .LP
  1862. Invoke a device-specific control routine.  On a KISS TNC
  1863. interface, this sends control packets to the TNC.  Data bytes are
  1864. treated as decimal.  For example, \fBparam ax0 1 255 \fP will set the keyup
  1865. timer (type field = 1) on the KISS TNC configured as ax0 to 2.55 seconds
  1866. (255 x .01 sec).  On a SLIP interface, the \fBparam\fP command allows the baud
  1867. rate to be read (without arguments) or set. On asy lines DTR and RTS can be
  1868. (and possibly should be) set with param iface dtr 1 and param iface rts 1.
  1869. The implementation of this
  1870. command for the various interface drivers is incomplete and subject to
  1871. change.
  1872. .br
  1873. Current commands defined are:
  1874.    0  Data       - Normal KISS data
  1875.    1  TxDelay    - set TX delay for TNC
  1876.    2  Persist    - set persistence delay for TNC
  1877.    3  Slottime   - set slottime delay for TNC
  1878.    4  TxTail     - set TX tail delay for TNC
  1879.    5  Fulldup    - set Full duplex for TNC
  1880.    6  Hardware   - Hardware dependent
  1881.    7  TxMute     -
  1882.    8  DTR        - 0 = down, 1 = up
  1883.    9  RTS        - 0 = down, 1 = up
  1884.   10  Speed      - baud rate
  1885.   11  Enddelay   -
  1886.   12  Group      -
  1887.   13  Idle       -
  1888.   14  Min        -
  1889.   15  Maxkey     -
  1890.   16  Wait       -
  1891.   17  Parity     - 0 = none, 1 = even, 2 = odd parity
  1892.  129  Down       -
  1893.  130  Up         -
  1894.  254  Return2    - Some tnc's need this
  1895.  255  Return     - Reset a tnc from KISS into command mode
  1896. .NH 2
  1897. ping <hostid> [<length> [<milliseconds> [<incflag>]]]
  1898. .LP
  1899. Ping (send ICMP Echo Request packets to) the specified host. By default
  1900. the data field contains only a small timestamp to aid in determining
  1901. round trip time; if the optional \fBlength\fP argument is given,
  1902. the appropriate number of data bytes (consisting of hex 55) are added to the
  1903. ping packets.
  1904. .LP
  1905. If \fBmilliseconds\fP is specified, pings will be repeated indefinitely
  1906. at the specified number of milliseconds;
  1907. otherwise a single, "one shot" ping is done.
  1908. Responses to one-shot pings appear asynchronously on the command screen,
  1909. while repeated pings create a session that may be suspended and resumed.
  1910. Pinging continues until the session is manually reset.
  1911. .LP
  1912. The \fBincflag\fP option causes a repeated ping to increment the
  1913. target IP address for each ping; it is an experimental feature for searching
  1914. blocks of IP addresses for active hosts.
  1915. .NH 2
  1916. pop <subcommand>
  1917. .LP
  1918. The \fBpop\fP client provides an automatic interface to the \fBpop\fP
  1919. server that is totaly transparen to the user; all that the user needs to do
  1920. is to set a few key parameters and the client will take it from there,
  1921. appart from registring with the server station manager for setting up
  1922. the user data. (see \fIpop userdata\fP command.
  1923. To read more about \fIpop\fP, read rfc937.
  1924. The following paragraph describe  the \fBpop\fP subcommands.
  1925. .NH 3
  1926. pop mailbox [<name>]
  1927. .LP
  1928. Show the defined name or sets the name to \fBname\fP for POP mail queries to
  1929. the mailhost. The server keeps the mail in the mailbox \fBname\fP located
  1930. in /spool/mail/\fBname\fP.txt. This is a mandatory parameter.
  1931. .NH 3
  1932. pop mailhost [<ipaddr>]
  1933. .LP
  1934. Show the currently defined host address for a \fBpop\fP server or sets the
  1935. IP address to the system named \fBipaddr\fP for POP connections.
  1936. This is a mandatory parameter.
  1937. .NH 3
  1938. pop kick
  1939. .LP
  1940. Start a POP connection now. (one shot connection)
  1941. .NH 3
  1942. pop timer [<seconds>]
  1943. .LP
  1944. Show the current setting and time remaining untill next server enquiry or
  1945. when \fBseconds\fP is given, defines the interval that a \fBpop\fP connection
  1946. is started every <seconds> to retrieve mail from the server system.
  1947. When the timer is not set the client is only started with a \fIpop kick\fP
  1948. command.
  1949. .NH 3
  1950. pop userdata <name> <password>
  1951. .LP
  1952. Sets up the userdata used for validation on the POP server system. Note
  1953. that <name> and <password> are case sensitive. When only pop userdata
  1954. is entered to show the values only the <name> is shown. (ultimate in
  1955. security, if you realy want to see the password look in the "ether").
  1956. Remember: the name and password should also be defined at the server
  1957. site in the \fIpopusers\fP file.
  1958. .NH 2
  1959. popmail <subcommand>
  1960. .LP
  1961. \fBpopmail\fP is a newer implementation of the pop client/server. It can
  1962. handle both pop2 and pop3 type pop client/servers. For functionality see
  1963. pop but the subcommands are different.
  1964. .NH 3
  1965. popmail addserver <host> [<seconds>] [hh:mm-hh:mm] <protocol> <mailbox> <username> <password>
  1966. .LP
  1967. Add \fBhost\P as a pop server. When \fBseconds\fP is given, a timer is started
  1968. to query the host with that interval for mail. If not specified no quering to
  1969. the pop host  will be started. You have to do that manualy with a kick.
  1970. When \fBhh:mm-hh:mm\fP is given then only in that exact timeframe are queries
  1971. to the host made (allowed).
  1972. \fBProtocol\fP is eighter POP2 or POP3, depending on the mail service the
  1973. host is providing. Note: pop2 is superceded by pop3. \fBMailbox\fP is the
  1974. mailbox name on the host where fore mail has to be picked up. \fBUsername\fP
  1975. and \fBpassword\fP are this systems validation parameters for the host.
  1976. Note that on entering this command the host name is looked up. If non exsistant
  1977. an error message is presented.
  1978. .NH 3
  1979. popmail dropserver <host>
  1980. .LP
  1981. Drops \fBhost\fP from the list of pop servers to be queried.
  1982. All  references to the entry are deleted from the current system.
  1983. .NH 3
  1984. popmail kick <host>
  1985. .LP
  1986. Starts a pop session with \fBhost\fP to retrieve mail. This command is needed
  1987. when no interval is specified with the \fBpopmail addserver\fP command.
  1988. .NH 3
  1989. popmail list
  1990. .LP
  1991. Lists the current popmail server table.
  1992. .NH 3
  1993. popmail quiet <yes|no>
  1994. .LP
  1995. Displays or sets the notification of new mail ariving via pop.
  1996. .NH 3
  1997. popmail trace <level>
  1998. .LP
  1999. Displays or sets the trace level of pop sessions. Current trace levels are:
  2000.  0 - No tracing
  2001.  1 - Serious errors reported
  2002.  2 - Transient errors reported
  2003.  3 session progress reported
  2004. Note that tracing only goes to the log file.
  2005. .NH 2
  2006. ppp <subcommands>
  2007. .LP
  2008. These commands are used for Point to Point Protocol interfaces.
  2009. .LP
  2010. This implementation of PPP is designed to be as complete as possible.
  2011. Because of this, the number of options can be rather daunting.
  2012. However, a typical PPP configuration might include the following commands:
  2013. .DS
  2014. attach asy 0x3f8 4 ppp pp0 4096 1500 9600
  2015. dial pp0 30 <hostid> 3 dialer.pp0
  2016. #
  2017. ppp pp0 lcp local accm 0
  2018. ppp pp0 lcp local compress address on
  2019. ppp pp0 lcp local compress protocol on
  2020. ppp pp0 lcp local magic on
  2021. ppp pp0 lcp open active
  2022. #
  2023. ppp pp0 ipcp local compress tcp 16 1
  2024. ppp pp0 ipcp open active
  2025. #
  2026. route add default pp0
  2027. .DE
  2028. .NH 3
  2029. ppp <iface>
  2030. .LP
  2031. Display the status of the PPP interface.
  2032. .NH 3
  2033. ppp <iface> lcp ...
  2034. .LP
  2035. These commands are used for the LCP [Link Control Protocol]
  2036. configuration.
  2037. .NH 4
  2038. ppp <iface> lcp close
  2039. .LP
  2040. Shutdown the PPP interface.
  2041. .NH 4
  2042. ppp <iface> lcp local ...
  2043. .LP
  2044. These commands control the configuration of the local side of the link.
  2045. If an option is specified, the parameters will be used
  2046. as the initial values in configuration requests.
  2047. If not specified, that option will not be requested.
  2048. .LP
  2049. For each of these options,
  2050. the \fBallow\fP parameter will permit the remote
  2051. to include that option in its response,
  2052. even when the option is not included in the request.
  2053. By default, all options are allowed.
  2054. .NH 5
  2055. ppp <iface> lcp local accm [ <bitmap> | allow [on | off] ]
  2056. .LP
  2057. Display or set the Async Control Character Map.
  2058. The default is 0xffffffff.
  2059. .NH 5
  2060. ppp <iface> lcp local authenticate [ pap | none | allow [on | off] ]
  2061. .LP
  2062. Display or set the authentication protocol.
  2063. The default is \fBnone\fP.
  2064. .NH 5
  2065. ppp <iface> lcp local compress address/control [ on | off | allow [on | off] ]
  2066. .LP
  2067. Display or set the option to compress the address and control fields of
  2068. the PPP HLDC-like header.
  2069. This is generally desirable for slow asynchronous links,
  2070. and undesirable for fast or synchronous links.
  2071. The default is off.
  2072. .NH 5
  2073. ppp <iface> lcp local compress protocol [ on | off | allow [on | off] ]
  2074. .LP
  2075. Display or set the option to compress the protocol field of
  2076. the PPP HLDC-like header.
  2077. This is generally desirable for slow asynchronous links,
  2078. and undesirable for fast or synchronous links.
  2079. The default is off.
  2080. .NH 5
  2081. ppp <iface> lcp local magic [ on | off | <value> | allow [on | off] ]
  2082. .LP
  2083. Display or set the initial Magic Number.
  2084. The default is off (zero).
  2085. .NH 5
  2086. ppp <iface> lcp local mru [ <size> | allow [on | off] ]
  2087. .LP
  2088. Display or set the Maximum Receive Unit.
  2089. The default is 1500.
  2090. .NH 5
  2091. ppp <iface> lcp local default
  2092. .LP
  2093. Reset the options to their default values.
  2094. .NH 4
  2095. ppp <iface> lcp open active | passive
  2096. .LP
  2097. Wait for the physical layer to come up.
  2098. If \fBactive\fP, initiate configuration negotiation.
  2099. If \fBpassive\fP, wait for configuration negotiation from the remote.
  2100. .NH 4
  2101. ppp <iface> lcp remote ...
  2102. .LP
  2103. These commands control the configuration of the remote side of the link.
  2104. The options are identical to those of the local side.
  2105. If an option is specified, the parameters will be used
  2106. in responses to the remote's configuration requests.
  2107. If not specified, that option will be accepted if it is allowed.
  2108. .LP
  2109. For each of these options,
  2110. the \fBallow\fP parameter will permit the remote
  2111. to specify that option in its request.
  2112. By default, all options are allowed.
  2113. .NH 4
  2114. ppp <iface> lcp timeout [<seconds>]
  2115. .LP
  2116. Display or set the interval to wait between configuration
  2117. or termination attempts.
  2118. The default is 3 seconds.
  2119. .NH 4
  2120. ppp <iface> lcp try ...
  2121. .LP
  2122. These commands are used for the various counters.
  2123. .NH 5
  2124. ppp <iface> lcp try configure [<count>]
  2125. .LP
  2126. Display or set the number of configuration requests sent.
  2127. The default is 10.
  2128. .NH 5
  2129. ppp <iface> lcp try failure [<count>]
  2130. .LP
  2131. Display or set the number of bad configuration requests allowed from the remote.
  2132. The default is 5.
  2133. .NH 5
  2134. ppp <iface> lcp try terminate [<count>]
  2135. .LP
  2136. Display or set the number of termination requests sent before shutdown.
  2137. The default is 2.
  2138. .NH 3
  2139. ppp <iface> ipcp ...
  2140. .LP
  2141. These commands are used for the IPCP [Internet Protocol Control Protocol]
  2142. configuration.
  2143. .LP
  2144. The \fBclose, open, timeout\fP and \fBtry\fP sub-commands
  2145. are identical to the LCP (described above).
  2146. .NH 4
  2147. ppp <iface> ipcp local ...
  2148. .LP
  2149. These commands control the configuration of the local side of the link.
  2150. If an option is specified, the parameters will be used
  2151. as the initial values in configuration requests.
  2152. If not specified, that option will not be requested.
  2153. .LP
  2154. For each of these options,
  2155. the \fBallow\fP parameter will permit the remote
  2156. to include that option in its response,
  2157. even when the option is not included in the request.
  2158. By default, all options are allowed.
  2159. .NH 5
  2160. ppp <iface> ipcp local address [ <hostid> | allow [on | off] ]
  2161. .LP
  2162. Display or set the local address for negotiation purposes.
  2163. If an address of 0 is specified,
  2164. the other side of the link will supply the address.
  2165. By default, no addresses are negotiated.
  2166. .NH 5
  2167. ppp <iface> ipcp local compress [ tcp <slots> [<flag>] | none | allow [on | off] ]
  2168. .LP
  2169. Display or set the compression protocol.
  2170. The default is \fBnone\fP.
  2171. .LP
  2172. The \fBtcp\fP <slots> specifies the number of "conversation" slots,
  2173. which must be 1 to 255.
  2174. (This may be limited at compilation time to a smaller number.)
  2175. A good choice is in the range 4 to 16.
  2176. .LP
  2177. The \fBtcp\fP <flag> is 0 (don't compress the slot number)
  2178. or 1 (OK to compress the slot number).
  2179. KA9Q can handle compressed slot numbers, so the default is 1.
  2180. .NH 4
  2181. ppp <iface> ipcp remote ...
  2182. .LP
  2183. These commands control the configuration of the remote side of the link.
  2184. The options are identical to those of the local side.
  2185. If an option is specified, the parameters will be used
  2186. in responses to the remote's configuration requests.
  2187. If not specified, that option will be accepted if it is allowed.
  2188. .LP
  2189. For each of these options,
  2190. the \fBallow\fP parameter will permit the remote
  2191. to specify that option in its request.
  2192. By default, all options are allowed.
  2193. .NH 3
  2194. ppp <iface> pap ...
  2195. .LP
  2196. These commands are used for the PAP [Password Authentication Protocol]
  2197. configuration.
  2198. .LP
  2199. The \fBtimeout\fP and \fBtry\fP sub-commands
  2200. are identical to the LCP (described above).
  2201. However, the terminate counter is unused.
  2202. .NH 4
  2203. ppp <iface> pap user [ <username> [<password>] ]
  2204. .LP
  2205. Display or set the username (the password may be set, but not displayed).
  2206. When the username is specified, but no password is supplied,
  2207. the \fBftpusers\fP file is searched for the password.
  2208. When a username/password is unknown or rejected,
  2209. a session will appear at the console to prompt for a new username/password.
  2210. .NH 3
  2211. ppp <iface> trace [<flags>]
  2212. .LP
  2213. Display or set the flags that control the logging of information
  2214. during PPP link configuration.
  2215. .LP
  2216. The flag value is 0 for none, 1 for basic, and 2 for general.
  2217. Values greater than 2 are usually not compiled,
  2218. and are described in the appropriate source files where they are defined.
  2219. .NH 2
  2220. ps
  2221. .LP
  2222. Display all current processes in the system. The fields are as follows:
  2223. .LP
  2224. \fBPID\fP - Process ID (the address of the process descriptor).
  2225. .LP
  2226. \fBSP\fP - The current value of the process stack pointer.
  2227. .LP
  2228. \fBstksize\fP - The size of the stack allocated to the process.
  2229. .LP
  2230. \fBmaxstk\fP - The apparent peak stack utilization of this process. This is
  2231. done in a somewhat heuristic fashion, so the numbers should be treated
  2232. as approximate. If this number reaches or exceeds the stksize figure,
  2233. the system is almost certain to crash; the \fInos.exe\fP program
  2234. should be recompiled to give the process a larger allocation when it is started.
  2235. .LP
  2236. \fBevent\fP - The event this task is waiting for, if it is not runnable.
  2237. .LP
  2238. \fBfl\fP - Process status flags. There are three: I (Interrupts enabled),
  2239. W (Waiting for event) and S (suspended). The I
  2240. flag is set whenever a task has executed a pwait() call (wait for
  2241. event) without first disabling hardware interrupts. Only tasks that
  2242. wait for hardware interrupt events will turn off this flag; this is
  2243. done to avoid critical sections and missed interrupts. The W flag
  2244. indicates that the process is waiting for an event; the \fBevent\fP
  2245. column will be non-blank. Note that although there may be several
  2246. runnable processes at any time (shown in the \fBps\fP listing as those
  2247. without the W flag and with blank event fields) only one
  2248. process is actually running at any one instant (The Refrigerator
  2249. Light Effect says that the \fBps\fP command is always the one running
  2250. when this display is generated.)
  2251. .NH 2
  2252. pwd [<dirname>]
  2253. .LP
  2254. An alias for the \fBcd\fP command.
  2255. .NH 2
  2256. rarp <subcommand>
  2257. .LP
  2258. This uses the reverse address resolution protocol.
  2259. .NH 3
  2260. rarp query <iface> <callsign>
  2261. .LP
  2262. This starts a reverse resolution request via \fBiface\fP to find the
  2263. IP address for \fBcallsign\fP. It counts down for 10 seconds before
  2264. giving up listening for an answer.
  2265. .NH 2
  2266. record [off | <filename>]
  2267. .LP
  2268. Append to \fBfilename\fP all data received on the current
  2269. session.  Data sent on the current session is also written into the file
  2270. except for Telnet sessions in remote echo mode.  The command \fBrecord
  2271. off\fP stops recording and closes the file.
  2272. .NH 2
  2273. remote [-p <port>] [-k <key>] [-a <kickaddr>] <hostid> exit | reset | kick
  2274. .LP
  2275. Send a UDP packet to the specified host commanding it
  2276. to exit the \fBNos\fP program, reset the processor,
  2277. or force a retransmission on TCP connections.  For this
  2278. command to be accepted, the remote system must be running the \fBremote\fP
  2279. server and the port number specified in the \fBremote\fP command must match
  2280. the port number given when the server was started on the remote system.
  2281. If the port numbers do not match, or if the remote server is not running
  2282. on the target system, the command packet is ignored.  Even if the
  2283. command is accepted there is no acknowledgement.
  2284. .LP
  2285. The \fBkick\fP command forces a retransmission timeout on all
  2286. TCP connections that the remote node may have with the local node.
  2287. If the -a option is used, connections to the specified host are
  2288. kicked instead. No key is required for the kick subcommand.
  2289. .LP
  2290. The \fBexit\fP and \fBreset\fP subcommands are mainly useful for
  2291. restarting the nos program on a remote
  2292. unattended system after the configuration file has been updated.  The
  2293. remote system should invoke the \fBNos\fP program automatically upon booting,
  2294. preferably in an infinite loop.  For example, under MS-DOS the boot disk
  2295. should contain the following in \fBautoexec.bat\fP:
  2296. .DS
  2297. .ft CW
  2298. :loop
  2299. nos
  2300. goto :loop
  2301. .ft P
  2302. .DE
  2303. .LP
  2304. .NH 3
  2305. remote -s <key>
  2306. .LP
  2307. The exit and reset subcommands of remote require a password.
  2308. The password is set
  2309. on a given system with the \fB-s\fP option, and it is specified in a command
  2310. to a remote system with the \fB-k\fP option. If no password is set with the
  2311. \fB-s\fP option, then the exit and reset subcommands are disabled.
  2312. .LP
  2313. Note that \fBremote\fP is an experimental feature in NOS; it is \fInot\fP
  2314. yet supported by any other TCP/IP implementation.
  2315. .NH 2
  2316. rename <oldfilename> <newfilename>
  2317. .LP
  2318. Rename \fBoldfilename\fP to \fBnewfilename\fP.
  2319. .NH 2
  2320. reset [<session>]
  2321. .LP
  2322. Reset the specified session; if no argument is given, reset the current
  2323. session.  This command should be used with caution since it does not
  2324. reliably inform the remote end that the connection no longer exists.  (In
  2325. TCP a reset (RST) message will be automatically generated should the remote
  2326. TCP send anything after a local reset has been done.  In AX.25 the DM
  2327. message performs a similar role.  Both are used to get rid of a lingering
  2328. half-open connection after a remote system has crashed.)
  2329. .NH 2
  2330. rip <subcommand>
  2331. .LP
  2332. These commands are used for the RIP service.
  2333. .NH 3
  2334. rip accept <gateway>
  2335. .LP
  2336. Remove the specified gateway from the RIP filter table, allowing future
  2337. broadcasts from that gateway to be accepted.
  2338. .NH 3
  2339. rip add <hostid> <seconds> [<flags>]
  2340. .LP
  2341. Add an entry to the RIP broadcast table. The IP routing table will be sent
  2342. to \fBhostid\fP every interval of \fBseconds\fP. If
  2343. \fBflags\fP is specified as 1, then "split horizon" processing will
  2344. be performed
  2345. for this destination. That is, any IP routing table entries pointing to the
  2346. interface that will be used to send this update will be removed from the
  2347. update.  If split horizon processing is not specified, then all routing
  2348. table entries except those marked "private" will be sent in each update.
  2349. (Private entries are never sent in RIP packets).
  2350. .LP
  2351. Triggered updates are always done. That is, any change in the routing table
  2352. that causes a previously reachable destination to become unreachable will
  2353. trigger an update that advertises the destination with metric 15, defined to
  2354. mean "infinity".
  2355. .LP
  2356. Note that for RIP packets to be sent properly to a broadcast address, there
  2357. must exist correct IP routing and ARP table entries that will first steer
  2358. the broadcast to the correct interface and then place the correct link-level
  2359. broadcast address in the link-level destination field. If a standard IP
  2360. broadcast address convention is used (eg. 128.96.0.0 or 128.96.255.255)
  2361. then chances are you already have the necessary IP routing table entry, but
  2362. unusual subnet or cluster-addressed networks may require special attention.
  2363. However, an \fBarp add\fP command will be required to translate this address to
  2364. the appropriate link level broadcast address. For example,
  2365. .sp
  2366. .DS I 0
  2367. .ft CW
  2368. arp add 128.96.0.0 ethernet ff:ff:ff:ff:ff:ff
  2369. .ft P
  2370. .DE
  2371. .sp
  2372. for an Ethernet network (ip address is a sample only!!!), and
  2373. .sp
  2374. .DS I 0
  2375. .ft CW
  2376. arp add 44.255.255.255 ax25 qst-0
  2377. .ft P
  2378. .DE
  2379. .sp
  2380. for an AX25 packet radio channel. (If multiple AX25 interfaces, make a unique
  2381. address for each interface.)
  2382. .NH 3
  2383. rip drop <dest>
  2384. .LP
  2385. Remove an entry from the RIP broadcast table.
  2386. .NH 3
  2387. rip merge [on | off]
  2388. .LP
  2389. This flag controls an experimental feature for consolidating redundant
  2390. entries in the IP routing table. When rip merging is enabled, the table is
  2391. scanned after processing each RIP update. An entry is considered redundant
  2392. if the target(s) it covers would be routed identically by a less "specific"
  2393. entry already in the table. That is, the target address(es) specified
  2394. by the entry in question must also match the target addresses of the
  2395. less specific entry and the two entries must have the same interface
  2396. and gateway fields. For example, if the routing table contains
  2397. .sp
  2398. .DS I 0
  2399. .ft CW
  2400. Dest            Len Interface    Gateway          Metric  P Timer  Use
  2401. 1.2.3.4         32  ethernet0    128.96.1.2       1       0 0      0
  2402. 1.2.3           24  ethernet0    128.96.1.2       1       0 0      0
  2403. .ft
  2404. .DE
  2405. .sp
  2406. then the first entry would be deleted as redundant since packets sent to
  2407. 1.2.3.4 will still be routed correctly by the second entry. Note that the
  2408. relative metrics of the entries are ignored.
  2409. .NH 3
  2410. rip refuse <gateway>
  2411. .LP
  2412. Refuse to accept RIP updates from the specified gateway by adding the
  2413. gateway to the RIP filter table. It may be later removed with the \fBrip
  2414. accept\fP command.
  2415. .NH 3
  2416. rip request <gateway>
  2417. .LP
  2418. Send a RIP Request packet to the specified gateway, causing it to reply
  2419. with a RIP Response packet containing its routing table.
  2420. .NH 3
  2421. rip status
  2422. .LP
  2423. Display RIP status, including a count of the number of packets sent
  2424. and received, the number of requests and responses, the number of
  2425. unknown RIP packet types, and the number of refused RIP updates from hosts
  2426. in the filter table. A list of the addresses and intervals
  2427. to which periodic RIP updates are being sent is also shown, along with
  2428. the contents of the filter table.
  2429. .NH 3
  2430. rip trace [0 | 1 | 2]
  2431. .LP
  2432. This variable controls the tracing of incoming and outgoing RIP packets.
  2433. Setting it to 0 disables all RIP tracing. A value of 1 causes changes
  2434. in the routing table to be displayed, while packets that cause no changes
  2435. cause no output. Setting the variable to 2 produces maximum output,
  2436. including tracing of RIP packets that cause no change in the routing table.
  2437. .NH 3
  2438. rip ttl <seconds>
  2439. .LP
  2440. Displays or sets the time to live timer to \fBseconds\fP. Normal timeout
  2441. value is 240 seconds. This is not the ttl in a rip broadcast (16 = infinite).
  2442. Set this timer before starting rip. Change this timer only in cooperation with
  2443. your surrounding nodes. Default is 240 seconds.
  2444. .NH 2
  2445. rlogin host
  2446. .LP
  2447. Sets up an rlogin session via port 511 to an *NIX compatible station.
  2448. Defaut terminal is an ansi (as defined with the fkeys) compatible terminal.
  2449. Default user name is guest. (Redefine with set USER= environement variable).
  2450. .NH 2
  2451. rmdir <dirname>
  2452. .LP
  2453. Remove a sub-directory from the current working directory.
  2454. .NH 2
  2455. route
  2456. .LP
  2457. With no arguments, \fBroute\fP displays the IP routing table.
  2458. .NH 3
  2459. route add <dest_hostid>[/bits] | default <iface> [<gateway_hostid> | direct [<metric>]]
  2460. .LP
  2461. This command adds an entry to the routing table. It requires at least two
  2462. more arguments, the hostid of the target destination and the name of
  2463. the interface to which its packets should be sent.  If the destination is
  2464. not local, the gateway's hostid should also be specified. (If the interface
  2465. is a point-to-point link, then \fBgateway_hostid\fP may be omitted even if the
  2466. target is non-local because this field is only used to determine the
  2467. gateway's link level address, if any.  If the destination is directly
  2468. reachable, \fBgateway_hostid\fP is also unnecessary since the destination
  2469. address is used to determine the interface link address).
  2470. If \fBrspf\fP is used and the system is a switch / router to multiple
  2471. routes the keyword \fBdirect\fP can be used i.s.o a \fBgateway_hostid\fP to
  2472. set the metric higher as the default 1. This way routes advertized by
  2473. other \fBrspf\fP stations can be cheaper and get selected.
  2474. If \fBdirect\fP is given but \fBmetric\fP not, an new algoritm is used
  2475. to set the metric dependent on the number of subnet mask bits.
  2476. .LP
  2477. The optional \fB/bits\fP suffix to the destination host id specifies how
  2478. many leading bits in the host id are to be considered significant in the
  2479. routing comparisons.  If not specified, 32 bits (i.e., full significance) is
  2480. assumed.  With this option, a single routing table entry may refer to
  2481. many hosts all sharing a common bit string prefix in their IP addresses.
  2482. For example, ARPA Class A, B and C networks would use suffixes of /8,
  2483. /16 and /24 respectively; the command
  2484. .DS I 0
  2485. .ft CW
  2486. route add 44/8 sl0 44.64.0.2
  2487. .ft P
  2488. .DE
  2489. .LP
  2490. causes any IP addresses beginning with "44" in the first 8 bits to be
  2491. routed to 44.64.0.2; the remaining 24 bits are "don't-cares".
  2492. .LP
  2493. When an IP address to be routed matches more than one entry in the routing
  2494. table, the entry with largest \fBbits\fP parameter (i.e., the "best" match)
  2495. is used. This allows individual hosts or blocks of hosts to be exceptions
  2496. to a more general rule for a larger block of hosts.
  2497. .LP
  2498. The special destination \fBdefault\fP is used to route datagrams to
  2499. addresses not matched by any other entries
  2500. in the routing table; it is equivalent to specifying a
  2501. \fB/bits\fP suffix of /0 to any destination hostid.  Care must be taken with
  2502. default entries since two nodes with default entries pointing at each
  2503. other will route packets to unknown addresses back and forth in a loop
  2504. until their time-to-live (TTL) fields expire.  (Routing loops for
  2505. specific addresses can also be created, but this is less likely to occur
  2506. accidentally).
  2507. .LP
  2508. There are two build in interfaces: \fBloopback\fP and \fBencap\fP.
  2509. \fBLoopback\fP is for internal purposes only. The \fBencap\fP is an IP
  2510. encapsulator interface. This is used to encapsulate a complete IP datagram
  2511. into a IP datagram so that it gets "piggy-backed". It is often used
  2512. to carry ampr.org datagrams (net44) over the Internet. Note that the
  2513. Internet is fully connected and that ampr.org is (at least) very loose.
  2514. This way two sites can interchange net44 datagrams to each other.
  2515. Some extra notes: A Internet gateway has 2 IP addresses: one on ampr.org
  2516. and one on the Internet. You should make sure that the interface
  2517. connected to the Internet has the ifconfig ipaddr set correctly.
  2518. Note: This previously only worked as gateway for other stations. There was
  2519. some guessing done in picking an IP address when encap is used localy.
  2520. The guessing takes the worst guess. (always wrong with a 2.7 Murphy factor)
  2521. The code now uses the local IP address as source when the route starts
  2522. at the local station. If this is not what you want, you can overrule this
  2523. by setting the IP address of the psuedo encap interface to what you want
  2524. it to be.
  2525. .LP
  2526. Some extra notes on encap: I have 3 systems on an ethernet with network
  2527. 129.179.122.128/25. In the office I have another net linked to the Internet.
  2528. The addresses there are in the 129.179.122.0/25 range. Now i have a radio
  2529. link with 44.137.0.2 and 44.137.1.2 on respective sites. On the 44.137.0.2
  2530. system i have \fIroute add 44.0.0.0/8 encap 44.137.1.1 99\fP. On a next
  2531. system on my local ethernet i have 44.137.0.1 / 129.179.122.129.
  2532. To get from that system to say 44.62.0.1 i have to add an encap to my
  2533. local gateway with \fIroute add 44.0.0.0/8 encap 129.179.122.130\fP.
  2534. A \fIroute add default ec0 129.179.122.130\fP gives me access to the
  2535. Internet.
  2536. Otherwise it will lookup the address for the interface to be used to
  2537. reach 129.179.122.130 and will use 129.179.122.129. Now 44.62.0.1
  2538. will NEVER know where it came from. So adding the encap on the second
  2539. system solves the problem.
  2540. .LP
  2541. Here are some examples of the \fBroute\fP command:
  2542. .DS I 0
  2543. .ft CW
  2544. # Route datagrams to IP address 44.0.0.3 to SLIP line #0.
  2545. # No gateway is needed because SLIP is point-to point.
  2546. route add 44.0.0.3 sl0
  2547.  
  2548. # Route all default traffic to the gateway on the local Ethernet
  2549. # with IP address 44.0.0.1
  2550. route add default ec0 44.0.0.1
  2551.  
  2552. # The local Ethernet has an ARPA Class-C address assignment;
  2553. # route all IP addresses beginning with 192.4.8 to it
  2554. route add 192.4.8/24 ec0
  2555.  
  2556. # The station with IP address 44.0.0.10 is on the local AX.25 channel
  2557. route add 44.0.0.10 ax0
  2558.  
  2559. # An encapsulation link to 192.4.8.12 where the subnet 44.64.0.0 is
  2560. accessible. The internet does not know where we are but we just use them
  2561. with what they know:
  2562. route add 44.64.0.0/16 encap 192.4.8.12 4
  2563.  
  2564. .ft P
  2565. .DE
  2566. .NH 3
  2567. route addprivate <dest hostid>[/bits] | default <iface> [<gateway hostid> [<metric>]]
  2568. .LP
  2569. This command is identical to \fBroute add\fP except that it also marks the new
  2570. entry as private; it will never be included in outgoing RIP updates.
  2571. .NH 3
  2572. route drop <dest hostid>
  2573. .LP
  2574. \fBroute drop\fP deletes an entry from the table. If a packet arrives for the
  2575. deleted address and a default route is in effect, it will be used.
  2576. .NH 2
  2577. rspf <subcmd>
  2578. .LP
  2579. RSPF is the Radio Shortest Path First protocol. Each station listens for RRH
  2580. (Router to Router Hello) messages. When such a RRH message is received,
  2581. \fBNos\fP will figure out if the link is bi-directional by pinging the other
  2582. station. The protocol is described in the RSPF 2.1 specification.
  2583. .NH 3
  2584. rspf interface <interface> <quality> <horizon>
  2585. .LP
  2586. <interface> is the required interface rspf should use.
  2587. quality is from 1 to 127
  2588. horizon is between 1 to 255
  2589. End nodes should have the quality set to 1. Immediate nodes normaly set the
  2590. quality to 8. The normaly used value for horizon is 32.
  2591. .NH 3
  2592. rspf mode [vc | datagram | none]
  2593. .LP
  2594. Without arguments, displays the preferred mode for RSPF.
  2595. Modes are VC (Virtual Cirquit) and Datagram. none resets the preferred mode.
  2596. .NH 3
  2597. rspf rrhtimer [seconds]
  2598. .LP
  2599. Without arguments, displays the rrh timer value.
  2600. .NH 3
  2601. rspf suspecttimer [seconds]
  2602. .LP
  2603. Without arguments, displays the suspect timer value.
  2604. .NH 3
  2605. rspf timer [seconds]
  2606. .LP
  2607. Without arguments, displays the update timer value.
  2608. .LP
  2609. To activate RSPF, do the following.
  2610. Set the broadcast address for the destination interface, example ax0.
  2611.     ifconfig ax0 broadcast 44.255.255.255
  2612. .LP
  2613. This automatically creates a routing entry for 44.255.255.255 in the routing
  2614. table. If intend to use RSPF on more than one interface, those interfaces must
  2615. each have different broadcast adresses. Else the routing entries will be
  2616. overwriten by the next definition.
  2617. .LP
  2618. Configure ax0 as an RSPF interface with horizon 32 and a quality of 1 (hops).
  2619. This is typical for an end node. replace the 1 with an 8 for immediate nodes.
  2620.     rspf interface ax0 1 32
  2621.  Set the interval between RRH messages.
  2622.     rspf rrhtimer 900
  2623.  Define how long it takes until an idle link is suspected to be bad.
  2624.     rspf suspecttimer 2000
  2625.  Set the interval between routing updates.
  2626.     rspf timer 900
  2627. .NH 2
  2628. sccstat
  2629. .LP
  2630. Display the defined PE1CHL scc driver statistics.
  2631. .NH 2
  2632. session [[<session>] [flowmode [on | off]]]
  2633. .LP
  2634. Without arguments, displays the list of current sessions, including
  2635. session number, remote TCP or AX.25 address and the address of the TCP or
  2636. AX.25 control block.  An asterisk (*) is shown next to the current
  2637. that session.  Entering a session number as an argument to the \fBsession\fP
  2638. command will put you in \fIconverse\fP mode with that session.  If the Telnet
  2639. session; entering a blank line at this point puts you in converse mode with
  2640. server is enabled, the user is notified of an incoming request and a
  2641. session number is automatically assigned.  The user may then select the
  2642. session normally to converse with the remote user as though the session
  2643. had been locally initiated.
  2644. Adding the flowmode displays or enables / disables setting of *more*
  2645. handling for that session. This is handy for example by long directory
  2646. listings comming from an ftp session. Escaping to command mode before
  2647. issuing the dir command and entering "session # flowmode on" gives a
  2648. page at a time to look at. At any time you can escape out again and switch
  2649. flowmode off. Note that a ftp session has it's own flow command now buildin.
  2650. See FTP commands later in this manual.
  2651. .NH 2
  2652. shell [\c <command.com>]
  2653. .LP
  2654. Suspends \fBNos\fP and executes a sub-shell
  2655. ("command processor" under MS-DOS).
  2656. When the sub-shell exits, \fBNos\fP resumes
  2657. (under MS-DOS, enter the \fBexit\fP command).
  2658. Note: see the \fBCOMSPEC\fP environement variable.
  2659. When \c is given, command.com is then a command processor to be executed.
  2660. Background activity (FTP servers, etc) is also suspended
  2661. while the subshell executes. Note that this will fail unless there is
  2662. sufficient unused memory for the sub-shell and whatever command the user
  2663. tries to run.
  2664. When shelled out, Mailbox Operator connects and ttylink incomming connections
  2665. are refuced. A System unattended message is send to the "connector" of that
  2666. socket.
  2667. .NH 2
  2668. skick #socket
  2669. .LP
  2670. This is a shorthand for the various kick subcommands. This one searches the
  2671. socket for correct type and kicks the transport layer.
  2672. .NH 2
  2673. smtp <subcommand>
  2674. .LP
  2675. These commands are used for the Simple Message Transport Protocol service
  2676. (that is, mail).
  2677. .NH 3
  2678. smtp batch [yes | no]
  2679. .LP
  2680. If set smtp will batch the commands into one frame. When off only one
  2681. command is send and a response is waited for. Some old and flaky
  2682. smtp servers cannot handle more than one command at a time. \fBNos\fP can
  2683. handle multiple. If you are not hindered by an old smpt server, setting
  2684. batch reduces bandwith.
  2685. .NH 3
  2686. smtp gateway [<hostid>]
  2687. .LP
  2688. Displays or sets the host to be used as a "smart" mail relay. Any mail sent
  2689. to a host not in the host table will instead be sent to the gateway for
  2690. forwarding.
  2691. .NH 3
  2692. smtp kick
  2693. .LP
  2694. Run through the outgoing mail queue and attempt to deliver any pending mail.
  2695. This command allows the user to "kick" the mail system manually.
  2696. Normally, this command is periodically invoked by a timer
  2697. whenever \fBNos\fP is running.
  2698. .NH 3
  2699. smtp kill [<jobid>]
  2700. .LP
  2701. Kill the job and delete the message.
  2702. .NH 3
  2703. smtp list
  2704. .LP
  2705. List the current jobs. A "L" means locked and in progress.
  2706. It is wise to add in autoexec.bat a "del /spool/mqueue/*.lck" command
  2707. .NH 3
  2708. smtp maxclients [<count>]
  2709. .LP
  2710. Displays or sets the maximum number of simultaneous outgoing SMTP sessions
  2711. that will be allowed. The default is 10; reduce it if network congestion
  2712. is a problem.
  2713. .NH 3
  2714. smtp mode [queue | route]
  2715. .LP
  2716. Sets the smtp delivery mode. If queue, all messages are left in /spool/rqueue
  2717. for external forwarding and handling. If route, messages are handled,
  2718. if for local, appended to a mailbox or if remote, they are forwarded.
  2719. .NH 3
  2720. smtp mxlookup [yes | no]
  2721. .LP
  2722. Displays or sets a flag enabling or disabling MX record lookups. This can
  2723. be enabled if a domain server is available in the near distance (reachable).
  2724. It should be disabled (default) if no domain server is in reach to satisfy
  2725. the MX query. Note that MX record handling is very limited in NOS. If an
  2726. answer from a domain name server comes in it is taken to be the destination.
  2727. .NH 3
  2728. smtp quiet [yes | no]
  2729. .LP
  2730. Enables or disables the message that new mail arrived at this system.
  2731. .NH 3
  2732. smtp timer [<seconds>]
  2733. .LP
  2734. Displays or sets the interval, between scans of the outbound
  2735. mail queue. For example, \fBsmtp timer 600\fP will cause the system to check
  2736. for outgoing mail every 10 minutes and attempt to deliver anything it finds,
  2737. subject of course to the \fBsmtp maxclients\fP limit. Setting a value of zero
  2738. disables
  2739. queue scanning altogether, note that this is the default!  This value is
  2740. recommended for stand alone IP gateways that never handle mail, since it
  2741. saves wear and tear on the floppy disk drive.
  2742. .NH 3
  2743. smtp trace [<value>]
  2744. .LP
  2745. Displays or sets the trace flag in the SMTP client, allowing you to
  2746. watch SMTP's conversations as it delivers mail.  Zero (the default)
  2747. disables tracing.
  2748. .NH 2
  2749. socket [[<socket #>] [flowmode [yes | no]]]
  2750. .LP
  2751. Without an argument, displays all active sockets, giving their index
  2752. and type, the address of the associated protocol control block and the
  2753. and owner process ID and name. If the index to an active socket is
  2754. supplied, the status display for the appropriate protocol is called.
  2755. For example, if the socket refers to a TCP connection, the display will
  2756. be that given by the \fBtcp status\fP command with the protocol control
  2757. block address.
  2758. \fBFlow\fP mode can be set or cleared on a session if so wanted. This comes
  2759. in handy when a large directory is displayed by ftp. Escaping from the session
  2760. just before entering dir and setting flowmode and returning to that session,
  2761. gives a screen full at a time with -more- processing.
  2762. .NH 2
  2763. source <filename>
  2764. .LP
  2765. Read subsequent commands from \fBfilename\fP until EOF. Then resume reading
  2766. commands from the previous stream. This can be used to keep routing statements
  2767. in a separate file, wich can be read at some point in \fBautoexec.nos\fP.
  2768. .NH 2
  2769. start ax25 | convers | discard | echo | finger | ftp | lpd | netrom | nntp | pop | pop2 | pop3 | remote | rip | smtp | telnet | tip | ttylink 
  2770. .LP
  2771. Start the specified Internet server, allowing remote connection requests.
  2772. .NH 2
  2773. status
  2774. .LP
  2775. Displays load information on \fBNos\fP. When started, how long running,
  2776. open files etc.
  2777. .NH 2
  2778. stop ax25 | convers | discard | echo | finger | ftp | lpd | netrom | nntp | pop | pop2 | pop3 | remote | rip | smtp | telnet | tip | ttylink 
  2779. .LP
  2780. Stop the specified Internet server, rejecting any further remote connect
  2781. requests. Existing connections are allowed to complete normally.
  2782. .NH 2
  2783. tail <filename>
  2784. .LP
  2785. This does a more on the last couple of lines of file \fBfilename\fP.
  2786. .NH 2
  2787. tcp <subcommand>
  2788. .LP
  2789. These commands are used for the Transmission Control Protocol service.
  2790. .NH 3
  2791. tcp irtt [<milliseconds>]
  2792. .LP
  2793. Display or set the initial round trip time estimate, in milliseconds, to be
  2794. used for new TCP connections until they can measure and adapt to the
  2795. actual value.  The default is 5000 milliseconds (5 seconds).
  2796. Increasing this when operating
  2797. over slow channels will avoid the flurry of retransmissions that would
  2798. otherwise occur as the smoothed estimate settles down at the correct
  2799. value. Note that this command should be given before servers are started in
  2800. order for it to have effect on incoming connections.
  2801. .LP
  2802. TCP also keeps a \fIcache\fP of measured round trip times and mean
  2803. deviations (MDEV) for current and recent destinations. Whenever a new
  2804. TCP connection is opened, the system first looks in this cache. If the
  2805. destination is found, the cached IRTT and MDEV values are used. If not,
  2806. the default IRTT value mentioned above is used, along with a MDEV of 0.
  2807. This feature is fully automatic, and it can improve performance greatly
  2808. when a series of connections are opened and closed to a given destination
  2809. (eg. a series of FTP file transfers or directory listings).
  2810. .NH 3
  2811. tcp kick <tcb_addr>
  2812. .LP
  2813. If there is unacknowledged
  2814. data on the send queue of the specified TCB, this command forces
  2815. an immediate retransmission.
  2816. .NH 3
  2817. tcp mss [<size>]
  2818. .LP
  2819. Display or set the TCP Maximum Segment Size in bytes that will be sent on all
  2820. outgoing TCP connect request (SYN segments).  This tells the remote end the
  2821. size of the largest segment (packet) it may send. Changing MSS affects
  2822. only future connections; existing connections are unaffected.
  2823. .NH 3
  2824. tcp reset <tcb_addr>
  2825. .LP
  2826. Deletes the TCP control block at the specified address.
  2827. .NH 3
  2828. tcp rtt <tcb_addr> <milliseconds>
  2829. .LP
  2830. Replaces the automatically computed round trip time in the specified TCB
  2831. with the rtt in milliseconds.  This command is useful to speed up
  2832. recovery from a series of lost packets since it provides a manual bypass
  2833. around the normal backoff retransmission timing mechanisms.
  2834. .NH 3
  2835. tcp status [<tcb_addr>]
  2836. .LP
  2837. Without arguments, displays several TCP-level statistics, plus a summary of
  2838. all existing TCP connections, including TCB address, send and receive queue
  2839. sizes, local and remote sockets, and connection state. If \fBtcb_addr\fP is
  2840. specified, a more detailed dump of the specified TCB is generated, including
  2841. send and receive sequence numbers and timer information.
  2842. .NH 3
  2843. tcp syndata [yes | no]
  2844. .LP
  2845. Display or set the tcp syn + data pigybacking flag. Some tcp systems cannot
  2846. handle syn + data together.
  2847. .NH 3
  2848. tcp timertype [linear | exponential]
  2849. .LP
  2850. Displays the current setting or sets the timer type backoff algoritm.
  2851. .NH 3
  2852. tcp trace [yes | no]
  2853. .LP
  2854. Display or set the tcp trace flag on or off.
  2855. .NH 3
  2856. tcp window [<size>]
  2857. .LP
  2858. Displays or sets the default receive window size in bytes to be used by TCP
  2859. when creating new connections. Existing connections are unaffected.
  2860. .NH 2
  2861. telnet <hostid> [<port>]
  2862. .LP
  2863. Creates a Telnet session to the specified host and enters converse mode.
  2864. If <port> is given that number is used. Default port is 23.
  2865. .NH 2
  2866. test
  2867. .LP
  2868. Start an internal test for an overflow problem that might appear in the
  2869. clock function of some AT computers.
  2870. .NH 2
  2871. thirh-party [yes | no]
  2872. .LP
  2873. This is a restriction setter for some countries where stations are not
  2874. allowed to handle thirth party mail traffic.
  2875. .NH 2
  2876. ttylink <hostid> [<port>]
  2877. .LP
  2878. Creates a Telnet session to the specified host and enters converse mode.
  2879. If <port> is given that number is used. Default port is 87.
  2880. This uses a split screen interface for easy conversation.
  2881. .NH 2
  2882. tip <iface>
  2883. .LP
  2884. Creates a \fBtip\fP session that
  2885. connects to the specified interface in "dumb terminal" mode.
  2886. The interface must have already been attached with the \fBattach\fP command.
  2887. Any packet
  2888. traffic (IP datagrams, etc) routed to the interface while this session
  2889. exists will be discarded.
  2890. To close a \fBtip\fP session, use the \fBreset\fP command. It
  2891. will then revert to normal \fBslip, nrs\fP or \fBkiss\fP mode operation.
  2892. .LP
  2893. This feature is primarily useful for manually establishing SLIP connections.
  2894. At present, only the built-in "com" ports can be used with this command.
  2895. .NH 2
  2896. trace [<iface> [off | <btio> [<tracefile>]]]
  2897. .LP
  2898. Controls packet tracing by the interface drivers. Specific bits enable
  2899. tracing of the various interfaces and the amount of information produced.
  2900. Trace output to the screen is only send to the command screen, when in a session
  2901. tracing to the screen is suspended. (From version 2.0l)
  2902. Tracing is controlled on a per-interface basis; without arguments, \fBtrace\fP
  2903. gives a list of all defined interfaces and their tracing status.
  2904. Output can be limited to a single interface by specifying it, and the
  2905. control flags can be change by specifying them as well. The flags are
  2906. given as a hexadecimal number which is interpreted as follows:
  2907. .DS I 0
  2908. .ft CW
  2909.     O - Enable tracing of output packets if 1, disable if 0
  2910.     I - Enable tracing of input packets if 1, disable if 0
  2911.     T - Controls type of tracing:
  2912.     0 - Protocol headers are decoded, but data is not displayed
  2913.     1 - Protocol headers are decoded, and data (but not the
  2914.         headers themselves) are displayed as ASCII characters,
  2915.         64 characters/line. Unprintable characters are displayed
  2916.         as periods.
  2917.     2 - Protocol headers are decoded, and the entire packet
  2918.         (headers AND data) is also displayed in hexadecimal
  2919.         and ASCII, 16 characters per line.
  2920.     B - Broadcast filter flag. If set, only packets specifically addressed
  2921.     to this node will be traced; broadcast packets will not be displayed.
  2922. .ft
  2923. .DE
  2924. If \fBtracefile\fP is not specified, tracing will be to the console.
  2925. .NH 2
  2926. udp status
  2927. .NH 2
  2928. verbose [0 | 1 | 2 | 3]
  2929. .LP
  2930. Set or display the level of message output in file transfers.
  2931. \fBVerbose 0\fP gives the least output, and \fBverbose 3\fP the most,
  2932. as follows:
  2933. .DS I 0
  2934. 0 - Display error messages only.
  2935. 1 - Display error messages plus a one-line summary after each transfer
  2936.     giving the name of the file, its size, and the transfer time and rate.
  2937. 2 - Display error and summary messages plus the progress messages generated
  2938.     by the remote FTP server. (This setting is the default.)
  2939. 3 - Display all messages. In addition, a "hash mark" (#) is displayed for
  2940.     every 1,000 bytes sent or received.
  2941. .DE
  2942. If a command is sent to the
  2943. remote server because it is not recognized locally, the response
  2944. is always displayed, regardless of the setting of \fBverbose\fP.
  2945. This is necessary for commands like \fBpwd\fP (display working directory),
  2946. which would
  2947. otherwise produce no message at all if \fBverbose\fP were set to 0 or 1.
  2948. .LP
  2949. Displays the status of all UDP receive queues.
  2950. .NH 2
  2951. upload [<filename>]
  2952. .LP
  2953. Opens \fBfilename\fP and sends it on the current session as though it were
  2954. typed on the terminal.
  2955. .NH 2
  2956. watch
  2957. .LP
  2958. Displays the current software stopwatch values, with min and max readings
  2959. for each. This facility allows a programmer to measure the execution time
  2960. of critical sections of code with microsecond resolution.
  2961. This command is supported only on the IBM PC, and the meaning of each
  2962. stopwatch value depends on where the calls have been inserted for test
  2963. purposes; the distribution copy of \fInos\fP usually has no stopwatch calls.
  2964. .NH 2
  2965. watchdog [on | off]
  2966. .LP
  2967. Enables or disables the watchdog timer. If internal operations cease for
  2968. 300 second and watchdog is enabled, a system reset is performed. See the
  2969. remote command for setting up autoexec.bat.
  2970. .NH 2
  2971. ?
  2972. .LP
  2973. Same as the \fBhelp\fP command.
  2974. .bp
  2975. .NH 1
  2976. Attach Commands
  2977. .LP
  2978. This chapter details the attach commands for the various hardware interface
  2979. drivers. Not all of these drivers may be configured into every \fBNos\fP
  2980. binary; a list of the available types may be obtained by entering the
  2981. command \fBattach ?\fP.
  2982. .LP
  2983. Some parameters are accepted by several drivers. They are:
  2984. .NH 3
  2985. <bufsize>
  2986. .LP
  2987. For asynchronous devices (eg. COM ports operating in SLIP or NRS mode)
  2988. this parameter specifies the size of the receiver's ring buffer.
  2989. It should be large enough to hold incoming data at full line speed for
  2990. the longest time that the system may be busy in MS-DOS or the BIOS doing
  2991. a slow I/O operation (eg. to a floppy disk). A kilobyte is usually more
  2992. than sufficient.
  2993. .LP
  2994. For synchronous devices (eg. the \fBscc, hs, pc100, hapn\fP
  2995. and \fBdrsi\fP interfaces operating in HDLC mode),
  2996. the bufsize parameter specifies the largest packet
  2997. that may be received on the interface.  This should be set by mutual
  2998. agreement among stations sharing the channel. For standard AX.25 with a
  2999. maximum I-frame data size of 256 bytes, a value of 325 should provide an
  3000. adequate safety margin. On higher speed channels (eg. 56kb/s) larger
  3001. values (eg. 2K bytes) will provide much better performance and allow
  3002. full-sized Ethernet packets to be carried without fragmentation.
  3003. .NH 3
  3004. <ioaddr>
  3005. .LP
  3006. The base address of the interface's control registers.This might be specified
  3007.  in hex as 0xnnn or decimal. (nnn is the hexadecimal number).
  3008. .NH 3
  3009. <vector>
  3010. .LP
  3011. The interface's hardware interrupt (IRQ) vector, in decimal. When a vector
  3012. is followed by the character 'c' then the vector is added in a interrupt chain.
  3013. This way multiple devices can share the same interrupt vector
  3014. (hardware changes might be nessesary). A sample is the use of a 4 port comm
  3015. board sharing the same vector. The first attach command has a plain vector
  3016. and the following have the c appended. Note that the highest speed port
  3017. should be defined last (as it is served first by the chaining).
  3018. Do NOT specify the c with the first attach statement in that group as
  3019. unpredictable results will occure.
  3020.  attach asy 0x3f8 4 ax25 ax25 2048 256 1200
  3021.  attach asy 0x3f0 4c ax25 ax25 2048 256 9600
  3022. .NH 3
  3023. <iface>
  3024. .LP
  3025. The name (an arbitrary character string)
  3026. to be assigned to this interface. It is used to refer to the
  3027. interface in \fBifconfig\fP and \fBroute\fP commands and in \fBtrace\fP output.
  3028. .NH 3
  3029. <mtu>
  3030. .LP
  3031. The Maximum Transmission Unit size, in bytes.  Datagrams
  3032. larger than this limit will be fragmented at the IP layer into smaller
  3033. pieces. For AX.25 UI frames, this limits the size of the information field.
  3034. For AX.25 I frames, however, the \fBax25 paclen\fP parameter is also
  3035. relevant.  If
  3036. the datagram or fragment is still larger than \fBpaclen\fP, it is also
  3037. fragmented at the AX.25 level (as opposed to the IP level) before
  3038. transmission.  (See the \fBax25 paclen\fP command for further information).
  3039. .NH 3
  3040. <speed>
  3041. .LP
  3042. The speed in bits per second (eg. 2400).
  3043. .NH 2
  3044. attach 3c500 <ioaddr> <vector> arpa <iface> <qlen> <mtu> [<ip_addr>]
  3045. .LP
  3046. Attach a 3Com 3C501 Ethernet interface.  \fBqlen\fP is the maximum allowable
  3047. transmit queue length.  If the \fBip_addr\fP parameter is not given, the value
  3048. associated with a prior \fBip address\fP command will be used.
  3049. .LP
  3050. The use of this driver is not recommended; use the packet driver interface
  3051. with the loadable 3C501 packet driver instead.
  3052. .NH 2
  3053. attach asy <ioaddr> <vector> ax25 | nrs | ppp | slip | raw <iface> <bufsize> <mtu>
  3054. <speed> [<vf>]
  3055. .LP
  3056. Attach a standard PC "com port" (asynchronous serial port),
  3057. using the National 8250 or 16550A chip.
  3058. Standard values on the IBM PC and clones for \fBioaddr\fP and \fBvector\fP
  3059. are 0x3f8 and 4 for COM1,
  3060. and 0x2f8 and 3 for COM2.
  3061. If the port uses a 16550A chip, it will be detected
  3062. automatically and the FIFOs enabled.
  3063. .NH 3
  3064. ax25
  3065. .LP
  3066. Similar to \fBslip\fP, except that an AX.25 header and a KISS TNC
  3067. control header are added to the front of the datagram before SLIP
  3068. encoding.  Either UI (connectionless) or I (connection-oriented) AX.25
  3069. frames can be used; see the \fBmode\fP command for details. 
  3070. .NH 3
  3071. nrs
  3072. .LP
  3073. Use the NET/ROM asynchronous framing technique for communication with
  3074. a local NET/ROM TNC.
  3075. .NH 3
  3076. ppp
  3077. .LP
  3078. Point-to-Point-Protocol.
  3079. Encapsulates datagrams in an HDLC-like frame.
  3080. This is a new Internet standard for point-to-point communication,
  3081. compatible with CCITT standards.
  3082. .NH 3
  3083. slip
  3084. .LP
  3085. Serial Line Internet Protocol.
  3086. Encapsulates IP datagrams directly in SLIP frames without a link
  3087. header. This is for operation on point-to-point lines and is compatible
  3088. with 4.2BSD UNIX SLIP.
  3089. .NH 3
  3090. raw
  3091. .LP
  3092. Raw serial line without protocol , special for lpd server.
  3093. .NH 3
  3094. <vf>
  3095. .LP
  3096. The optional flags are a string of the characters "vf":
  3097. \fBv\fP enables Van Jacobson TCP/IP Header Compression,
  3098. and is valid only for SLIP.
  3099. \fBf\fP forces the fifo on for 16550AFN compatible chips not hindered by the
  3100. original "design bug" and not needing the work-around. Unfortunate these
  3101. good chips don't get their fifo enabled. Specifying \fBf\fP on the attach
  3102. line forces the fifo to be used. (unpredictable results occure when specified
  3103. on a non 16550 type chip).
  3104. .NH 2
  3105. attach axip <iface> <mtu> <ip_addr> <callsign>
  3106. .LP
  3107. This creates a RFC1226 compatible AX.25 frame encapsulator for transmission
  3108. of AX.25 frames over the \fBInternet\fP. \fBIface\fP will be the name
  3109. of the interface, \fBip_addr\fP
  3110. the address of the remote system and \fBcallsign\fP the AX.25 callsign
  3111. this station is listening on for frames to digipeat.
  3112. Note that each attached axip interface should have a different callsign
  3113. to listen to and this should also be different from other callsign's used
  3114. on this station.
  3115. .NH 2
  3116. attach drsi <ioaddr> <vector> ax25 <iface> <bufsize> <mtu> <ch_a_speed>
  3117. <ch_b_speed>
  3118. .LP
  3119. N6TTO driver for the Digital Radio Systems PCPA 8530 card.
  3120. Since there are two channels on the board, two interfaces are attached.
  3121. They will be named \fBiface\fP with 'a' and 'b' appended.
  3122. \fBbufsize\fP is the receiver buffer size in bytes;
  3123. it must be larger than the largest frame to be received.
  3124. \fBch_a_speed\fP and \fBch_b_speed\fP are the speeds, in bits/sec,
  3125. for the A and B channels, respectively.
  3126. .NH 2
  3127. attach eagle <ioaddr> <vector> ax25 <iface> <bufsize> <mtu> <speed>
  3128. .LP
  3129. WA3CVG/NG6Q driver for the Eagle Computer card (Zilog 8530).
  3130. .NH 2
  3131. attach hapn <ioaddr> <vector> ax25 <iface> <bufsize> <mtu> csma | full
  3132. .LP
  3133. KE3Z driver for the Hamilton Amateur Packet Network adapter (Intel 8273).
  3134. The \fBcsma | full\fP parameter specifies whether the port should operate in
  3135. carrier sense multiple access (CSMA) mode or in full duplex.
  3136. .NH 2
  3137. attach hs <ioaddr> <vector> ax25 <iface> <bufsize> <mtu> <keyup_delay> <p>
  3138. .LP
  3139. Attach a DRSI PCPA or Eagle Computer interface card
  3140. using a special "high speed" 8530 driver.
  3141. This driver uses busy-wait loops to send and receive
  3142. each byte instead of interrupts, making it usable with high speed modems
  3143. (such as the WA4DSY 56kb/s modem) on slow systems.
  3144. This does have the side effect of "freezing"
  3145. the system whenever the modem transmitter or receiver is active.
  3146. This driver can operate only in CSMA mode, and it is recommended that
  3147. no other interfaces requiring small interrupt latencies be attached to
  3148. the same machine.
  3149. .LP
  3150. The \fBkeyup_delay\fP parameter specifies the transmitter keyup delay in
  3151. byte time intervals. The \fBp\fP value specifies the transmitter persistence
  3152. value in the range 1-255; the corresponding slot time is fixed at one
  3153. hardware clock tick, about 55 ms on the PC.
  3154. .LP
  3155. As with the other 8530 drivers, this driver actually attaches two interfaces,
  3156. one for each 8530 channel.
  3157. .NH 2
  3158. attach packet <intvec> <iface> <txqlen> <mtu>
  3159. .LP
  3160. Driver for use with separate software "packet drivers" meeting the
  3161. FTP Software, Inc, Software Packet Driver specification.
  3162. The driver must have already been installed before the
  3163. \fBattach\fP command is given. Packet drivers in the Ethernet, ARCNET,
  3164. SLIP, SLFP, and KISS/AX25 classes are supported.
  3165. .LP
  3166. \fBintvec\fP is the software interrupt vector used for communication to the
  3167. packet driver, and \fBtxqlen\fP is the maximum number of packets that will
  3168. be allowed on the transmit queue.
  3169. .NH 2
  3170. attach pc100 <ioaddr> <vector> ax25 <iface> <bufsize> <speed>
  3171. .LP
  3172. Driver for the PACCOMM PC-100 (Zilog 8530) card.
  3173. Only AX.25 operation is supported.
  3174. .NH 2
  3175. attach scc <devices> init <addr> <spacing> <Aoff> <Boff> <Dataoff> <intack>
  3176. <vec> [p | r]<clock> [<hdwe>] [<param>]
  3177. .LP
  3178. PE1CHL driver to initialize a generic SCC (8530) interface board
  3179. prior to actually attaching it. The parameters are as follows:
  3180. .NH 3
  3181. <devices>
  3182. .LP
  3183. The number of SCC chips to support.
  3184. .NH 3
  3185. <addr>
  3186. .LP
  3187. The base address of the first SCC chip (hex).
  3188. .NH 3
  3189. <spacing>
  3190. .LP
  3191. The spacing between the SCC chip base addresses.
  3192. .NH 3
  3193. <Aoff>
  3194. .LP
  3195. The offset from a chip's base address to its channel A control register.
  3196. .NH 3
  3197. <Boff>
  3198. .LP
  3199. The offset from a chip's base address to its channel B control register.
  3200. .NH 3
  3201. <Dataoff>
  3202. .LP
  3203. The offset from each channel's control register to its data register.
  3204. .NH 3
  3205. <intack>
  3206. .LP
  3207. The address of the INTACK/Read Vector port. If none,
  3208. specify 0 to read from RR3A/RR2B.
  3209. .NH 3
  3210. <vec>
  3211. .LP
  3212. The CPU interrupt vector for all connected SCCs.
  3213. .NH 3
  3214. <clock>
  3215. .LP
  3216. The clock frequency (PCLK/RTxC) of all SCCs in hertz.
  3217. Prefix with 'p' for PCLK, 'r' for RTxC clock (for baudrate gen).
  3218. .NH 3
  3219. <hdwe>
  3220. .LP
  3221. Optional hardware type. The following values are currently supported:
  3222. 1 - Eagle card, 2 - PACCOMM PC-100, 4 - PRIMUS-PC card (DG9BL), 8 - DRSI
  3223. PCPA card.
  3224. .NH 3
  3225. <param>
  3226. .LP
  3227. Optional extra parameter. At present, this is used only with the PC-100
  3228. and PRIMUS-PC cards to set the modem mode. The value 0x22 is used with
  3229. the PC-100 and 0x2 is used with the PRIMUS-PC card.
  3230. .LP  
  3231. The \fBattach scc ... init\fP command must be given
  3232. before the interfaces are actually attached with the following command.
  3233. .NH 2
  3234. attach scc <chan> slip | kiss | nrs | ax25 <iface> <mtu> <speed> <bufsize> [<call>]
  3235. .LP
  3236. Attach an initialized SCC port to the system. The parameters are as follows:
  3237. .NH 3
  3238. <chan>
  3239. .LP
  3240. The SCC channel number to attach, 0 or 1 for the first chip's A or B port,
  3241. 2 or 3 for the second chip's A or B port, etc.
  3242. .NH 3
  3243. slip | kiss | nrs | ax25
  3244. .LP
  3245. The operating mode of the interface. \fBslip, kiss\fP
  3246. and \fBnrs\fP all operate the
  3247. port hardware in asynchronous mode; \fBslip\fP
  3248. is Internet-standard serial line
  3249. IP mode, \fBkiss\fP generates SLIP frames containing KISS TNC commands and
  3250. AX.25 packets and \fBnrs\fP uses NET/ROM local serial link framing conventions
  3251. to carry NET/ROM packets. Selecting \fBax25\fP mode puts the interface into
  3252. synchronous HDLC mode that is suitable for direct connection to a half duplex
  3253. radio modem.
  3254. .NH 3
  3255. <speed>
  3256. .LP
  3257. The interface speed in bits per second (eg. 1200).
  3258. Prefix with 'd' when an external divider
  3259. is available to generate the TX clock. When the clock source is PCLK,
  3260. this can be a /32 divider between TRxC and RTxC. When the clock is at RTxC,
  3261. the TX rate must be supplied at TRxC. This is needed only for full duplex
  3262. synchronous operation. When this arg is given as 'ext', the transmit and
  3263. receive clocks are external, and the internal baud rate generator (BRG)
  3264. and digital phase locked loop (DPLL) are not used.
  3265. .bp
  3266. .NH 2
  3267. Attach Examples
  3268. .LP
  3269. Here are some examples of the attach command:
  3270. .LP
  3271. .DS I 0
  3272. .ft CW
  3273. # Attach a 3Com Ethernet controller using the standard 3Com address and
  3274. # vector (i.e., as it comes out of the box) to use ARPA-standard encapsulation.
  3275. # The receive queue is limited to 5 packets, and outgoing packets larger
  3276. # than 1500 bytes will be fragmented
  3277. attach 3c500 0x300 3 arpa ec0 5 1500
  3278.  
  3279. # Attach the PC asynch card normally known as "com1" (the first controller)
  3280. # to operate in point-to-point slip mode at 9600 baud, calling it "sl0".
  3281. # A 1024 byte receiver ring buffer is allocated. Outgoing packets larger
  3282. # than 256 bytes are fragmented.
  3283. attach asy 0x3f8 4 slip sl0 1024 256 9600
  3284.  
  3285. # Attach the secondary PC asynch card ("com2") to operate in AX.25 mode
  3286. # with an MTU of 576 bytes at 9600 baud with a KISS TNC, calling it "ax0".
  3287. # By default, IP datagrams are sent in UI frames
  3288. attach asy 0x2f8 3 ax25 ax0 1024 576 9600
  3289.  
  3290. # Attach a axip wormhole
  3291. attach axip ai0 256 129.179.122.10 pa0gri-11
  3292. # on the other side of the wormhole
  3293. attach axip ai0 256 129.179.122.130 pa0gri-12
  3294. # Now assume 129.179.122.10 has a AX.25 interface with callsign pa0gri-10
  3295. # and 129.179.122.130 a interface with callsign pa0gri-8
  3296. # Now a AX.25 frame like: 
  3297. # pe1chl->pa0gri-11->pa0gri-8->pe1dna [ data]
  3298. # Received by pa0gri-11, set the has-been-digipeated change the interface
  3299. # callsign with the one it realy came in from and ecapsulates it
  3300. # in a IP frame type 93 and ships it to 129.179.122.130
  3301. # pe1chl->pa0gri-10*->pa0gri-8->pe1dna [ data]
  3302. # Arived at 129.179.122.130 the next digi is searched for and found.
  3303. # The frame is changed into:
  3304. # pe1chl->pa0gri-10*->pa0gri-12*->pe1dna [ data]
  3305. # so that on the way back the frame will find the "right" interface.
  3306.  
  3307. # Attach the packet driver loaded at interrupt 0x7e
  3308. # The packet driver is for an Ethernet interface
  3309. attach packet 0x7e ethernet 8 1500
  3310. .ft P
  3311. .DE
  3312. .LP
  3313. .bp
  3314. .NH 1
  3315. FTP Subcommands
  3316. .LP
  3317. During converse mode with an FTP server, everything typed on the console is
  3318. first examined to see if it is a locally-known command. If not, the line is
  3319. passed intact to the remote server on the control channel. If it is one of
  3320. the following commands, however, it is executed locally. (Note that this
  3321. generally involves other commands being sent to the remote server on the
  3322. control channel.)
  3323. .NH 2
  3324. dir [<file> | <directory> [<local file>]]
  3325. .LP
  3326. Without arguments, \fBdir\fP requests that a full directory listing of the remote
  3327. server's current directory be sent to the terminal.  If one argument is
  3328. given, this is passed along in the LIST command; this can be a specific
  3329. file or subdirectory that is meaningful to the remote file system. If two
  3330. arguments are given, the second is taken as the local file into which the
  3331. directory listing should be put (instead of being sent to the console).
  3332. The PORT command is used before the LIST command is sent.
  3333. .NH 2
  3334. flow [off|on]
  3335. .LP
  3336. Displays or sets the -more- processing on the current ftp session.
  3337. When set to on, a -more- prompt is displayed after each screen full of
  3338. data. You can do the same with a \fBsession # flow\fP command.
  3339. Note that this is a local extension to the standard ftp command set.
  3340. .NH 2
  3341. get <remote file> [<local file>]
  3342. .LP
  3343. Asks the remote server to send the file specified in the first argument.
  3344. The second argument, if given, will be the name of the file on the local
  3345. machine; otherwise it will have the same name as on the remote machine.
  3346. The PORT and RETR commands are sent on the control channel.
  3347. .NH 2
  3348. hash
  3349. .LP
  3350. A synonym for the \fBverbose 3\fP command.
  3351. .NH 2
  3352. ls [<file> | <directory> [<local file>]]
  3353. .LP
  3354. \fBls\fP is identical to the \fBdir\fP command except that the "NLST"
  3355. command is
  3356. sent to the server instead of the "LIST" command. This results in an
  3357. abbreviated directory listing, i.e., one showing only the file names
  3358. themselves without any other information.
  3359. .NH 2
  3360. mget <file> [<file> ...]
  3361. .LP
  3362. Fetch a collection of files from the server. File names may include
  3363. wild card characters; they will be interpreted and expanded into a
  3364. list of files by the remote
  3365. system using the NLST command. The files will have the same name on
  3366. the local system that they had on the server.
  3367. .NH 2
  3368. mkdir <remote directory>
  3369. .LP
  3370. Creates a directory on the remote machine.
  3371. .NH 2
  3372. mput <file> [<file> ...]
  3373. .LP
  3374. Send a collection of files to the server. File names may include
  3375. wild card characters; they will be expanded locally into a list
  3376. of files to be sent. The files will have the same name on the
  3377. server as on the local system.
  3378. .NH 2
  3379. put <local file> [<remote file>]
  3380. .LP
  3381. Asks the remote server to accept data, creating the file named in the
  3382. first argument. The second argument, if given, will be the name of the file
  3383. on the remote machine; otherwise it will have the same name as on the local
  3384. machine.  The PORT and STOR commands are sent on the control channel.
  3385. .NH 2
  3386. rmdir <remote directory>
  3387. .LP
  3388. Deletes a directory on the remote machine.
  3389. .NH 2
  3390. type [a | i | l <bytesize>]
  3391. .LP
  3392. Tells both the local client and remote server the type of file that is
  3393. to be transferred.  The default, (wich can be changed with the \fBftype\fP
  3394. command) is 'a', which means ASCII (i.e., a text
  3395. file).  Type 'i' means \fIimage\fP, i.e., binary.  In ASCII mode, files are
  3396. sent as varying length lines of text in ASCII separated by cr/lf
  3397. sequences; in IMAGE mode, files are sent exactly as they appear in the
  3398. file system.  ASCII mode should be used whenever transferring text
  3399. between dissimilar systems (e.g., UNIX and MS-DOS) because of their
  3400. different end-of-line and/or end-of-file conventions.  When exchanging
  3401. text files between machines of the same type, either mode will work but
  3402. IMAGE mode is usually faster.  Naturally, when exchanging raw
  3403. binary files (executables, compressed archives, etc) IMAGE mode must be
  3404. used.  Type 'l' (logical byte size) is used when exchanging binary files
  3405. with remote servers having oddball word sizes (e.g., DECSYSTEM-10s and
  3406. 20s). Locally it works exactly like IMAGE, except that it notifies the
  3407. remote system how large the byte size is. \fBbytesize\fP is typically 8.
  3408. The type command sets the local transfer mode and generates the TYPE
  3409. command on the control channel.
  3410. .NH 2
  3411. verbose [0 | 1 | 2 | 3]
  3412. .LP
  3413. Set or display the level of message output in file transfers.
  3414. \fBVerbose 0\fP gives the least output, and \fBverbose 3\fP the most,
  3415. as follows:
  3416. .DS I 0
  3417. 0 - Display error messages only.
  3418. 1 - Display error messages plus a one-line summary after each transfer
  3419.     giving the name of the file, its size, and the transfer time and rate.
  3420. 2 - Display error and summary messages plus the progress messages generated
  3421.     by the remote FTP server. (This setting is the default.)
  3422. 3 - Display all messages. In addition, a "hash mark" (#) is displayed for
  3423.     every 1,000 bytes sent or received.
  3424. .DE
  3425. If a command is sent to the
  3426. remote server because it is not recognized locally, the response
  3427. is always displayed, regardless of the setting of \fBverbose\fP.
  3428. This is necessary for commands like \fBpwd\fP (display working directory),
  3429. which would
  3430. otherwise produce no message at all if \fBverbose\fP were set to 0 or 1.
  3431. .bp
  3432. .NH 1
  3433. Dialer Subcommands
  3434. .LP
  3435. Each dialer command may (should) have a different dialer file.
  3436. The file resides in the configuration directory,
  3437. as specified in the \fBInstallation\fP section (see chapter 1).
  3438. A typical dialer file might be:
  3439. .DS
  3440. .eo
  3441. # Set the speed, and toggle DTR to ensure modem is in command mode.
  3442. control down
  3443. wait 3000
  3444. speed 2400
  3445. control up
  3446. wait 3000
  3447. # Dial, and wait for connection
  3448. send "atdt555-1212\\r"
  3449. wait 45000 "CONNECT " speed
  3450. wait 2000
  3451. # PAD specific initialization
  3452. send "\\r"
  3453. wait 15000 "Terminal ="
  3454. send "ppp\\r"
  3455. wait 10000 "\\r\\n"
  3456. .ec \
  3457. .DE
  3458. .NH 3
  3459. control down | up
  3460. .LP
  3461. Control \fBasy\fP interface.
  3462. The \fBdown\fP option drops DTR and RTS.
  3463. The \fBup\fP option asserts DTR and RTS.
  3464. .NH 3
  3465. send "string"
  3466. .LP
  3467. This dialer command will write the specified string to the interface.
  3468. The string quote marks are required,
  3469. and the string may not contain embedded control characters.
  3470. However, the standard C string escape sequences are recognized
  3471. (\\0 should not be used).
  3472. .NH 3
  3473. speed [ 9600 | 4800 | 2400 | 1200 | 300 ]
  3474. .LP
  3475. This dialer command will set the speed of the interface to one of the
  3476. available speeds.
  3477. If the speed is missing,
  3478. the speed will be displayed in the dialer session window.
  3479. .NH 3
  3480. wait <milliseconds> [ "test string" ] [ speed ]
  3481. .LP
  3482. If only the time is specified,
  3483. the dialer pauses for the desired number of milliseconds.
  3484. .LP
  3485. Otherwise, the dialer reads until the test string is detected on the interface.
  3486. If the string is not detected within the desired time,
  3487. the autodialer will reset.
  3488. The string quote marks are required,
  3489. and the string may not contain embedded control characters.
  3490. However, the standard C string escape sequences are recognized
  3491. (\\0 should not be used).
  3492. .LP
  3493. Finally, if the \fIspeed\fP parameter is specified,
  3494. the dialer will continue to read characters until a non-digit is detected.
  3495. The string read is converted to an integer,
  3496. and used to set the interface speed.
  3497. If the trailing non-digit is not detected within the desired time,
  3498. or the integer value is not a valid speed,
  3499. the autodialer will reset.
  3500. .bp
  3501. .NH 1
  3502. Installation
  3503. .LP
  3504. \fBNos\fP uses the following file and directory structure:
  3505. .DS
  3506. ~/alias
  3507. ~/autoexec.nos
  3508. ~/dialer
  3509. ~/domain.txt
  3510. ~/ftpusers
  3511. ~/net.rc
  3512. ~/netron.sav
  3513. ~/popusers
  3514. ~/finger/
  3515. ~/etc/printcap
  3516. ~/etc/lpdperms
  3517. ~/etc/log
  3518. ~/spool/areas
  3519. ~/spool/mail.log
  3520. ~/spool/net.log
  3521. ~/spool/forward.bbs
  3522. ~/spool/history
  3523. ~/spool/rewrite
  3524. ~/spool/help/
  3525. ~/spool/mail/
  3526. ~/spool/mqueue/
  3527. ~/spool/news/
  3528. ~/spool/news/active
  3529. ~/spool/news/pointer
  3530. ~/spool/news/info
  3531. ~/spool/news/help
  3532. ~/spool/news/history
  3533. ~/spool/news/forward
  3534. ~/spool/news/poll
  3535. ~/spool/rqueue/
  3536. ~/spool/signatur/
  3537. ~/spool/lpd/
  3538. .DE
  3539. .LP
  3540. The ~ in front of all files is a directory offset definable with the
  3541. \fB-d\fP option on the \fBNos\fP command line. 
  3542. Any name may be chosen and is default empty. (eg. just /)
  3543. If for example \fB-d /net\fP is given, the structure shifts to /net/...
  3544. The \fBalias, autoexec.nos, dialer, domain.txt net.rc, popusers\fP
  3545. and \fBftpusers\fP configuration files are located here.
  3546. The \fBnetrom.sav\fP file will be created there.
  3547. .LP
  3548. The "/spool" directory and its sub-directories are used by the bbs,
  3549. SMTP and NNTP services.
  3550. The \fBareas, forward.bbs, history, mail.log\fP and \fBrewrite\fP
  3551. configuration files are located here.
  3552. The /spool/news directory can have many subdirectories and each
  3553. subdirectory can have subdirectories. Newsgroups are split into heirarchical
  3554. directory structures. A news article in newsgroup rec.amateur.radio.packet
  3555. will end up in /spool/news/rec/amateur/radio/packet.txt.
  3556. .NH 2
  3557. The /ftpusers File
  3558. .LP
  3559. Since MS-DOS is a single-user operating system (some might say it is
  3560. a glorified bootstrap loader), it provides
  3561. no access control; all files can be read, written or deleted by the
  3562. local user.  It is usually undesirable to give such open access to a
  3563. system to remote network users.  Net therefore provides its own
  3564. access control mechanisms.
  3565. .LP
  3566. The file \fBftpusers\fP controls remote FTP and mailbox access.
  3567. The FTP default
  3568. is \fIno\fP access; if this file does not exist, the FTP server will be
  3569. unusable.  A remote user must first "log in" to the system with the USER
  3570. and PASS commands, giving a valid name and password listed in \fBftpusers\fP,
  3571. before he or she can transfer files.
  3572. .LP
  3573. Each entry in \fBftpusers\fP consists of a single line of the form
  3574. .DS I 0
  3575. .ft CW
  3576. username password /path permissions ip_address
  3577. .ft P
  3578. .DE
  3579. .LP
  3580. There must be at least four fields, and there must be exactly one space
  3581. between each field.  Comments may be added after the last field.
  3582. Comment lines begin with '#' in column one.
  3583. .LP
  3584. \fBusername\fP is the user's login name.
  3585. .LP
  3586. \fBpassword\fP is the required password.  Note that this is in
  3587. plain text; therefore it is not a good idea to give general read
  3588. permission to the root directory.  A password of '*' (a single asterisk)
  3589. means that any password is acceptable.
  3590. .LP
  3591. \fB/path\fP is the allowable prefix on accessible files.  Before any
  3592. file or directory operation, the current directory and the user-
  3593. specified file name are joined to form an absolute path name in
  3594. "canonical" form (i.e., a full path name starting at the root, with "./"
  3595. and "../" references, as well as redundant /'s, recognized and removed).
  3596. The result MUST begin with the allowable path prefix; if not, the
  3597. operation is denied.  This field must always begin with a
  3598. "/", i.e., at the root directory.
  3599. Multiple directories can be specified by separating them with a ";"
  3600. caracter and no whitespace around them.
  3601. .LP
  3602. \fBpermissions\fP is a decimal number granting permission for read,
  3603. create and write operations.  If the low order bit (0x1) is set, the
  3604. user is allowed to read a file subject to the path name prefix
  3605. restriction.  If the next bit (0x2) is set, the user is allowed to
  3606. create a new file if it does not overwrite an existing file.  If the
  3607. third bit (0x4) is set, the user is allowed to write a file even if it
  3608. overwrites an existing file, and in addition he may delete files.  Again,
  3609. all operations are allowed subject to the path name prefix restrictions.
  3610. Permissions may be combined by adding bits, for example, 0x3 (= 0x2 + 0x1)
  3611. means that the user is given read and create permission, but not
  3612. overwrite/delete permission.
  3613. .LP
  3614. Additional permission bits used by the mailbox and PPP are:
  3615. .DS I 0
  3616. .ft CW
  3617.   1   Read files
  3618.   2   Create new files
  3619.   4   Overwrite and delete existing files
  3620.   8   AX.25 gateway operation allowed
  3621.   16  Telnet gateway operation allowed
  3622.   32  NET/ROM gateway operation allowed
  3623.   64  Remote sysop access allowed (DANGEROUS)
  3624.   128 This user is banned from BBS access (illegal user)
  3625.   256 Priv bit for PPP connection
  3626.   512 Priv bit for peerID/pass lookup
  3627.  1024 disallow send commands (except to SYSOP)
  3628.  2048 disallow read commands
  3629.  4096 disallow 3rd party mail
  3630.  8192 This station is a known BBS
  3631. .ft P
  3632. .DE
  3633. .LP
  3634. \fBip_address\fP is used for PPP only and is the remote IP address of the
  3635. connected system.
  3636. .LP
  3637. A username of \fBunivperm\fP has special meaning in the validation meganism.
  3638. If \fBunivperm\fP is included as a valid user in \fBftpusers\fP then
  3639. any unknown user (not in \fBftpusers\fP) will be mapped into \fBunivperm\fP
  3640. and get its permission bits and file path. If \fBunivperm\fP is not
  3641. included in \fBftpusers\fP unknown users are not permitted nor validated.
  3642. .LP
  3643. For example, suppose \fBftpusers\fP on machine
  3644. pc.ka9q.ampr.org contains the line
  3645. .DS I 0
  3646. .ft CW
  3647. friendly test /testdir 7
  3648. .ft P
  3649. .DE
  3650. .LP
  3651. A session using this account would look like this:
  3652. .DS I 0
  3653. .ft CW
  3654. net> ftp pc.ka9q.ampr.org
  3655. Resolving pc.ka9q.ampr.org... Trying 128.96.160.1...
  3656. FTP session 1 connected to pc.ka9q.ampr.org
  3657. 220 pc.ka9q.ampr.org FTP version 900418 ready at Mon May 7 16:27:18 1990
  3658. Enter user name: friendly
  3659. 331 Enter PASS command
  3660. Password: test [not echoed]
  3661. 230 Logged in
  3662. ftp>
  3663. .ft P
  3664. .DE
  3665. .LP
  3666. The user now has read, write, overwrite and delete privileges for any file
  3667. under /testdir; he may not access any other files.
  3668. .LP
  3669. Here are some more sample entries in \fBftpusers\fP:
  3670. .DS I 0
  3671. .ft CW
  3672. karn foobar / 7         # User "karn" with password "foobar" may read,
  3673.                         # write, overwrite and delete any file on the
  3674.                         # system.
  3675.  
  3676. guest bletch /g/bogus;/public 3
  3677.                         # User "guest" with password "bletch" may read
  3678.                         # any file under /g/bogus and its subdirectories,
  3679.                         # and /public and its subdirectories,
  3680.                         # and may create a new file as long as it does
  3681.                         # not overwrite an existing file. He may NOT
  3682.                         # delete any files.
  3683.  
  3684. anonymous * /public 1   # User "anonymous" (any password) may read files
  3685.                         # under /public and its subdirectories; he may
  3686.                         # not create, overwrite or delete any files.
  3687. .ft
  3688. .DE
  3689. .LP
  3690. This last entry is the standard convention for keeping a repository of
  3691. public files; in particular, the username "anonymous" is an established
  3692. ARPA convention. 
  3693. .NH 2
  3694. The /popusers File
  3695. .LP
  3696. Here are the username / password combinations defined for the POP users.
  3697. It has a simple convention:
  3698. .DS I 0
  3699. .ft CW
  3700. user:password:
  3701. .ft P
  3702. .DE
  3703. for every POP user such a line has to be added. The user and password
  3704. fields sould match the \fBpop userdata\fP statement of the remote user.
  3705. Both user and password have to be delimited with a colon character.
  3706. .NH 2
  3707. The /net.rc File
  3708. .LP
  3709. The net.rc file is a fast login file for known ftp stations. Each line
  3710. starts with the name of the ftp station. Following are a user and password
  3711. statemend to be send to the server for validation.
  3712. The name, user and password are separated with a space. Not a tab or more
  3713. than 1 space character.
  3714. Following is a sample net.rc file.
  3715. .DS I 0
  3716. .ft CW
  3717. ucsd.edu anonymous gvdg@gvdgpc.cdh.cdc.com
  3718. ka9q.ampr.org guest pa0gri
  3719. .ft P
  3720. .DE
  3721. .NH 2
  3722. The /domain.txt File
  3723. .LP
  3724. \fBNos\fP translates domain names (eg. "pc.ka9q.ampr.org") to IP addresses
  3725. (eg. 128.96.160.3) through the use of an Internet Domain Name resolver and
  3726. a local "cache" file, \fBdomain.txt\fP.
  3727. Whenever the user specifies a domain name,
  3728. the local cache is searched for the desired entry.
  3729. If it is present, it is used;
  3730. if not, and if domain name server(s) have been configured,
  3731. a query is sent over the network to the current server.
  3732. If the server responds,
  3733. the answer is added to the \fBdomain.txt\fP file for future use.
  3734. If the server does not respond, any additional servers on the list are
  3735. tried in a round-robin fashion until one responds,
  3736. or the retry limit is reached (see the \fBdomain retry\fP command).
  3737. If \fBdomain.txt\fP does not contain the
  3738. desired entry and there are no configured domain name servers,
  3739. then the request immediately fails.
  3740. .LP
  3741. If a domain name server is available, and if all references to host-ids in
  3742. your /\fBautoexec.nos\fP file are in IP address format, then it is
  3743. possible to start with a completely empty \fBdomain.txt\fP file
  3744. and have \fBNos\fP build it for you.  However, you may wish to
  3745. add your own entries to \fBdomain.txt\fP, either
  3746. because you prefer to use symbolic domain names in your
  3747. /\fBautoexec.nos\fP file
  3748. or you don't have access to a domain server and you need to create entries
  3749. for all of the hosts you may wish to access.
  3750. .LP
  3751. Each entry takes one line,
  3752. and the fields are separated by tabs.
  3753. For example:
  3754. .DS I 0
  3755. pc.ka9q.ampr.org.       IN      A       128.96.160.3
  3756. .DE
  3757. \fBIN\fP is the \fIclass\fP of the record.
  3758. It means \fIInternet\fP, and it will be found in all entries.
  3759. \fBA\fP is the \fItype\fP of the record, and it means that this is
  3760. an \fIaddress\fP record.
  3761. Domain name \fBpc.ka9q.ampr.org\fP therefore has Internet
  3762. address 128.96.160.3.
  3763. .LP
  3764. Another possible entry is the \fBCNAME\fP (Canonical Name) record.
  3765. For example:
  3766. .DS I 0
  3767. ka9q.ampr.org.          IN      CNAME   pc.ka9q.ampr.org.
  3768. .DE
  3769. This says that domain name "ka9q.ampr.org" is actually an alias for the
  3770. system with (primary, or \fIcanonical\fP) domain name "pc.ka9q.ampr.org."
  3771. When a domain name having a \fBCNAME\fP
  3772. record is given to \fBNos\fP, the system
  3773. automatically follows the reference to the canonical name and returns the
  3774. IP address associated with that entry.
  3775. .LP
  3776. Entries added automatically by \fBNos\fP will have an additional field between
  3777. the domain name and the class (\fBIN\fP) field.  For example:
  3778. .DS I 0
  3779. pc.ka9q.ampr.org.       3600    IN      A       128.96.160.3
  3780. .DE
  3781. This is the \fItime-to-live\fP value, in seconds, associated with the record
  3782. received from the server. Clients (such as \fBNos\fP) caching these records are
  3783. supposed to delete them after the time-to-live interval has expired,
  3784. allowing for the possibility that the information in the record may become
  3785. out of date.
  3786. .LP
  3787. This implementation of \fBNos\fP will decrement the TTL to zero, but will not
  3788. delete the record unless the "clean" flag is on
  3789. (see the \fBdomain cache clean\fP command).
  3790. When a remote server is not available, the old entry will be used.
  3791. .LP
  3792. When the \fITTL\fP value is missing (as in the examples above),
  3793. the record will never expire, and must be managed by hand.
  3794. Since \fBdomain.txt\fP is a plain text file,
  3795. it may be easily edited by the user to add, change or delete records.
  3796. .LP
  3797. Additional types of records, include NS (name server) and SOA (start of
  3798. authority) may appear in \fBdomain.txt\fP from remote server responses. These
  3799. are not currently used by \fBNos\fP but are retained for future development
  3800. (such as the incorporation of a domain name server into \fBNos\fP itself).
  3801. .NH 2
  3802. The /alias file.
  3803. .LP
  3804. SMTP server ALIAS file. This is for resolving a given target address into
  3805. a single or multiple entry mail list.
  3806.   Format:
  3807.     mail_list_name call_1@host_1 [call_2@host_2]......# comments
  3808. .LP
  3809.     pa0gri gvdg@fridley.cdh.cdc.com
  3810.     kelvin g1emm@g1emm.ampr.org
  3811.     #
  3812.     bob    gb3xp@gb3xp.ampr.org
  3813.     ian    g3rra@g3rra.ampr.org
  3814.     jim    g1wkk@g1wkk.ampr.org
  3815.     john   g5ds%gb3kp@gb3xp.ampr.org
  3816.     ted    gb3kp%gb3kp@gb3xp.ampr.org
  3817.     ron    g6vug@g6vug.ampr.org
  3818.     tim    g4uqe@g4uqe.ampr.org
  3819.     gareth g6kvk%gb7spv@gb3xp.ampr.org
  3820.     bolton gb7tcp%gb7crg@gb3xp.ampr.org
  3821.     julian g7efe%gb7cfb@gb3xp.ampr.org
  3822.     #
  3823.     world  g3rra@g3rra.ampr.org gb3xp@gb3xp.ampr.org g1plt@g1plt.ampr.org
  3824.        g1wkk@g1wkk.ampr.org g8kwi@g8kwi.ampr.org g6kvk%gb7spv@gb3xp.ampr.org
  3825.        g1ttg@g1ttg.ampr.org g6vug@g6vug.ampr.org g6kqz@g6kqz.ampr.org
  3826.        g4uqe@g4uqe.ampr.org g8ogr@g8ogr.ampr.org g4xwv@g4xwv.ampr.org
  3827.     #
  3828.     locals g3rra@g3rra.ampr.org g1wkk@g1wkk.ampr.org g8kwi@g8kwi.ampr.org
  3829.        g4bio@g4bio.ampr.org g1plt@g1plt.ampr.org g4uqe@g4uqe.ampr.org
  3830.        g6kqz@g6kqz.ampr.org g4tnu@g4tnu.ampr.org g6xqb@g6xqb.ampr.org
  3831. .LP
  3832. Note that it is reaonable, and sometimes desiable, to have alias records
  3833. in the form:
  3834.  
  3835.    area  area dest1 dest2
  3836.  
  3837. As the /alias file is scanned only once, this does not result in an
  3838. infinite recursion.
  3839. .NH 2
  3840. The /spool/areas file.
  3841. .LP
  3842. This file is a header file shown to a mailbox user when he requests the a
  3843. display. It should show all public mailboxes to read. Here is a sample:
  3844.     -------------  Public  --  Mail  --  Areas  -------------
  3845.                                                             |
  3846.     General    --    Any old chit-chat that is clean.       |
  3847.     TcpIp      --    General Tcp/Ip messages. NOS etc.      |
  3848.     Bugs       --    Where to report bugs in Ka9q-NOS       |
  3849.     Updates    --    Info - NOS version UPDATES by G1EMM.   |
  3850.                                                             |
  3851.     ---------------------------------------------------------
  3852. .NH 2
  3853. The /spool/forward.bbs file.
  3854. .LP
  3855. The mailbox reads a forwarding file, \fBspool/forward.bbs\fP. Here is a sample
  3856. file.
  3857.     wb0ttw 0006
  3858.     ax25 ax0 wb0ttw
  3859.     wb0ttw
  3860.     w0tn
  3861.     mspbul
  3862.     all
  3863.     ------
  3864.     wb0gdb
  3865.     netrom #msparh
  3866.     ..c msparh
  3867.     all
  3868.     ------
  3869. The first word on the first line in a forwarding record is the name of the BBS
  3870. to forward to. This should be the same type of name which is shown by the
  3871. \fImbox status\fP command. The second word is optional. It specifies a range
  3872. of hours when forwarding may take place. \fB0006\fP means that there will only
  3873. be forwarding to this station between midnight and 6am.
  3874. .LP
  3875. The second line specifies how to establish the connection. It should start with
  3876. the protocol (\fIax25, connect, tcp, telnet\fP or \fInetrom\fP) and be
  3877. followed by all the parameters which are nessesary when \fBNos\fP has
  3878. to establish a connection.
  3879. .LP
  3880. Directly after the second line, there may be lines that start with a dot.
  3881. What follows after the dot will be send to the remote BBS as soon as
  3882. the connection is established.
  3883. .LP
  3884. Then follows the names of a number of message areas, publib or private.
  3885. Finally, there should be a couple of '-' signs to separate one  forwarding
  3886. record from another. Also terminate the file with a last line of dashes.
  3887. .NH 2
  3888. The /spool/rewrite file.
  3889. .LP
  3890. Read the rewrite file for lines where the first word is a regular
  3891. expression and the second word are rewriting rules.
  3892. An optional third field, containing just the letter "r", when present, instructs
  3893. \fBNos\fP to restart the rewrite file, using the new destination address.
  3894. The special character '$' followed by a digit denotes the string that matched
  3895. a '*' character. The '*' characters are numbered from 1 to 9.
  3896. Example: the line "*@*.* $2@$1.ampr.org" would rewrite the address
  3897. "foo@bar.xxx" to "bar@foo.ampr.org".
  3898.     #
  3899.     *@g1emm.ampr.org $1
  3900.     *@g1emm.ampr $1
  3901.     *@g1emm $1
  3902.     #
  3903.     *!*!*!*!*!*!* $7%$6@$5@$4@$3@$2@$1
  3904.     *!*!*!*!*!* $6%$5@$4@$3@$2@$1
  3905.     *!*!*!*!* $5%$4@$3@$2@$1
  3906.     *!*!*!* $4%$3@$2@$1
  3907.     *!*!* $3%$2@$1
  3908.     *!* $2@$1
  3909.     !* $1 r
  3910.     #
  3911.     # The End
  3912. .LP
  3913. .bp
  3914. .NH 1
  3915. Setting Bufsize, Paclen, Maxframe, MTU, MSS and Window
  3916. .LP
  3917. Many \fBNos\fP users are confused by these parameters and do not know how to
  3918. set them properly. This chapter will first review these parameters and
  3919. then discuss how to choose values for them. Special emphasis is given to
  3920. avoiding interoperability problems that may appear when communicating
  3921. with non-\fBNos\fP implementations of AX.25.
  3922. .NH 2
  3923. Hardware Parameters
  3924. .LP
  3925. .NH 3
  3926. Bufsize
  3927. .LP
  3928. This parameter is required by most of \fBNos\fP's built-in HDLC drivers
  3929. (eg. those for the DRSI PCPA and the Paccomm PC-100). It specifies the size
  3930. of the buffer to be allocated for each receiver port. HDLC frames
  3931. larger than this value cannot be received.
  3932. .LP
  3933. There is no default \fBbufsize\fP; it must be specified in the \fBattach\fP
  3934. command for the interface.
  3935. .NH 2
  3936. AX25 Parameters
  3937. .NH 3
  3938. Paclen
  3939. .LP
  3940. Paclen limits the size of the data field in an AX.25 I-frame. This
  3941. value does \fInot\fP include the AX.25 protocol header (source,
  3942. destination and digipeater addresses).
  3943. .LP
  3944. Since unconnected-mode (datagram) AX.25 uses UI frames, this parameter
  3945. has no effect in unconnected mode.
  3946. .LP
  3947. The default value of \fBpaclen\fP is 256 bytes.
  3948. .NH 3
  3949. Maxframe
  3950. .LP
  3951. This parameter controls the number of I-frames that \fBNos\fP may send
  3952. on an AX.25 connection before it must stop and wait for an acknowledgement.
  3953. Since the AX.25/LAPB sequence number field is 3 bits wide, this number
  3954. cannot be larger than 7.
  3955. .LP
  3956. Since unconnected-mode (datagram) AX.25 uses UI frames that do not have
  3957. sequence numbers, this parameter does \fInot\fP apply to unconnected
  3958. mode.
  3959. .LP
  3960. The default value of \fBmaxframe\fP in \fBNos\fP is 1 frame.
  3961. .NH 2
  3962. IP and TCP Parameters
  3963. .NH 3
  3964. MTU
  3965. .LP
  3966. The MTU (Maximum Transmission Unit) is an interface parameter that
  3967. limits the size of the largest IP
  3968. datagram that it may handle.  IP datagrams routed to
  3969. an interface that are larger than its MTU are each split into two or more
  3970. \fIfragments\fP.
  3971. Each fragment has its own IP header and is handled by the network
  3972. as if it were a distinct IP datagram, but when it arrives at
  3973. the destination it is held by the IP layer until all of the other fragments
  3974. belonging to the original datagram have arrived. Then they are reassembled
  3975. back into the complete, original IP datagram. 
  3976. The minimum acceptable interface MTU is 28
  3977. bytes: 20 bytes for the IP (fragment) header, plus 8 bytes of data.
  3978. .LP
  3979. There is no default MTU in \fBNos\fP; it must be explicitly specified for
  3980. each interface as part of the \fBattach\fP command.
  3981. .NH 3
  3982. MSS
  3983. .LP
  3984. MSS (Maximum Segment Size) is a TCP-level parameter that limits the
  3985. amount of data that the \fIremote\fP TCP will send in a single TCP
  3986. packet. MSS values are exchanged in the SYN (connection request)
  3987. packets that open a TCP connection. In the \fBNos\fP implementation of TCP,
  3988. the MSS actually used by TCP is further reduced in order to avoid
  3989. fragmentation at the local IP interface. That is, the local TCP asks IP
  3990. for the MTU of the interface that will be used to reach the
  3991. destination. It then subtracts 40 from the MTU value to allow for the
  3992. overhead of the TCP and IP headers. If the result is less than the MSS
  3993. received from the remote TCP, it is used instead.
  3994. .LP
  3995. The default value of \fBMSS\fP is 512 bytes.
  3996. .NH 3
  3997. Window
  3998. .LP
  3999. This is a TCP-level parameter that controls how much data the local TCP
  4000. will allow the remote TCP to send before it must stop and wait for an
  4001. acknowledgement. The actual window value used by TCP when deciding how
  4002. much more data to send is referred to as the \fIeffective window\fP.
  4003. This is the smaller of two values: the window advertised by the remote
  4004. TCP minus the unacknowledged data in flight, and the \fIcongestion
  4005. window\fP, an automatically computed time-varying estimate of how much
  4006. data the network can handle.
  4007. .LP
  4008. The default value of \fBWindow\fP is 2048 bytes.
  4009. .NH 2
  4010. Discussion
  4011. .LP
  4012. .NH 3
  4013. IP Fragmentation vs AX.25 Segmentation
  4014. .LP
  4015. IP-level fragmentation often makes it possible to interconnect two
  4016. dissimilar networks, but it is best avoided whenever possible.
  4017. One reason is that when a single IP fragment is lost, all other fragments
  4018. belonging to the same datagram are effectively also lost and
  4019. the entire datagram must be retransmitted by the source.
  4020. Even without loss, fragments require the allocation of temporary buffer
  4021. memory at the destination, and it is never easy
  4022. to decide how long to wait for missing fragments before
  4023. giving up and discarding those that have already arrived.
  4024. A reassembly timer controls this process.
  4025. In \fBNos\fP it is (re)initialized with the \fBip rtimer\fP parameter
  4026. (default 30 seconds) whenever progress is made in reassembling a datagram
  4027. (i.e., a new fragment is received).
  4028. It is not necessary that all of the fragments belonging to a datagram
  4029. arrive within a single timeout interval, only that the interval between
  4030. fragments be less than the timeout.
  4031. .LP
  4032. Most subnetworks that carry IP have MTUs of 576 bytes or more, so
  4033. interconnecting them with subnetworks having smaller values can result in
  4034. considerable fragmentation. For this reason, IP implementors working with
  4035. links or subnets having unusually small packet size limits are encouraged
  4036. to use
  4037. \fItransparent fragmentation\fP,
  4038. that is, to devise schemes to break up large IP
  4039. datagrams into a sequence of link or subnet frames that are immediately
  4040. reassembled on the other end of the link or subnet into the original, whole IP
  4041. datagram without the use of IP-level fragmentation. Such a
  4042. scheme is provided in AX.25 Version 2.1.  It can break
  4043. a large IP or NET/ROM datagram into a series of \fBpaclen\fP-sized
  4044. AX.25 segments (not to be confused with TCP segments),
  4045. one per AX.25 I-frame, for transmission and reassemble them into
  4046. a single datagram at the other end of the link before handing it up to the
  4047. IP or NET/ROM module.  Unfortunately, the segmentation procedure is a new
  4048. feature in AX.25 and is not yet widely implemented;
  4049. in fact, \fBNos\fP is so far
  4050. the only known implementation. This creates some interoperability problems
  4051. between \fBNos\fP and non-\fBNos\fP nodes, in particular, standard
  4052. NET/ROM nodes being used to carry IP datagrams. This problem is discussed
  4053. further in the section on setting the MTU.
  4054. .NH 3
  4055. Setting paclen and bufsize
  4056. .LP
  4057. The more data you put into an AX.25 I frame, the smaller the AX.25
  4058. headers are in relation to the total frame size. In other words, by
  4059. increasing \fBpaclen\fP, you lower the AX.25 protocol overhead. Also, large
  4060. data packets reduce the overhead of keying up a transmitter, and this
  4061. can be an important factor with higher speed modems. On the other hand,
  4062. large frames make bigger targets for noise and interference. Each link
  4063. has an optimum value of \fBpaclen\fP that is best discovered by experiment.
  4064. .LP
  4065. Another thing to remember when setting \fBpaclen\fP is that the AX.25 version
  4066. 2.0 specification limits it to 256 bytes. Although \fBNos\fP can handle
  4067. much larger values, some other AX.25 implementations (including
  4068. digipeaters) cannot and this
  4069. may cause interoperability problems. Even \fBNos\fP may have trouble with
  4070. certain KISS TNCs because of fixed-size buffers. The original KISS TNC
  4071. code for the TNC-2 by K3MC can handle frames limited in size only by
  4072. the RAM in the TNC, but some other KISS TNCs cannot.
  4073. .LP
  4074. \fBNos\fP's built-in HDLC drivers (SCC, PC-100, DRSI, etc) allocate receive
  4075. buffers according to the maximum expected frame size, so it is
  4076. important that these devices be configured with the correct
  4077. \fBbufsize\fP. To do this, you must know the size of the largest
  4078. possible frame that can be received. The \fBpaclen\fP parameter
  4079. controls only the size of the data field in an I-frame and not the
  4080. total size of the frame as it appears on the air. The AX.25 spec allows
  4081. up to 8 digipeaters, so the largest possible frame is (\fBpaclen\fP + 72)
  4082. bytes. So you should make \fBbufsize\fP at least this large.
  4083. .LP
  4084. Another important consideration is that the more recent versions of NOS
  4085. improve interrupt response by maintaining a special pool of buffers for use
  4086. by the receive routines.  These buffers are currently fixed in size to 2048
  4087. bytes and this can be changed only by editing config.h and recompiling NOS.
  4088. This limits \fBbufsize\fP; in fact, attempting to set a larger value may
  4089. cause the driver not to work at all. This situation can be detected by
  4090. running the \fBmemory status\fP command and looking for a non-zero count
  4091. of \fBIbuffail\fP events, although these events can also occur
  4092. occasionally during normal operation.
  4093. .LP
  4094. One of the drawbacks of AX.25 that there is no way for one station to tell
  4095. another how large a packet it is willing to accept.  This requires the
  4096. stations sharing a channel to agree beforehand on a maximum packet size.
  4097. TCP is different, as we shall see.
  4098. .NH 3
  4099. Setting Maxframe
  4100. .LP
  4101. For best performance on a half-duplex radio channel, \fBmaxframe\fP should
  4102. always be set to 1. The reasons are explained in the paper \fILink Level
  4103. Protocols Revisited\fP by Brian Lloyd and Phil Karn, which appeared in the
  4104. proceedings of the ARRL 5th Computer Networking Conference in 1986.
  4105. .NH 3
  4106. Setting MTU
  4107. .LP
  4108. TCP/IP header overhead considerations similar to those of the AX.25 layer
  4109. when setting \fBpaclen\fP apply when choosing an MTU.  However, certain
  4110. subnetwork types supported by \fBNos\fP have well-established MTUs, and
  4111. these should
  4112. always be used unless you know what you're doing: 1500 bytes for Ethernet,
  4113. and 508 bytes for ARCNET.
  4114. The MTU for PPP is automatically negotiated, and defaults to 1500.
  4115. Other subnet types, including SLIP and AX.25, are
  4116. not as well standardized.
  4117. .LP
  4118. SLIP has no official MTU, but the most common
  4119. implementation (for BSD UNIX) uses an MTU of 1006 bytes.  Although
  4120. \fBNos\fP has no hard wired limit on the size of a received SLIP frame,
  4121. this is not true for other systems.
  4122. Interoperability problems may therefore result if larger MTUs are used in
  4123. \fBNos\fP.
  4124. .LP
  4125. Choosing an MTU for an AX.25 interface is more complex. When the interface
  4126. operates in datagram (UI-frame) mode, the \fBpaclen\fP parameter does not
  4127. apply. The MTU effectively becomes the \fBpaclen\fP of the link.  However,
  4128. as mentioned earlier, large packets sent on AX.25 \fIconnections\fP are
  4129. automatically segmented into I-frames no larger than \fBpaclen\fP bytes.
  4130. Unfortunately, as also mentioned earlier, \fBNos\fP is so far the only known
  4131. implementation of the new AX.25 segmentation procedure. This is fine as long
  4132. as all of the NET/ROM nodes along a path are running \fBNos\fP, but since the main
  4133. reason \fBNos\fP supports NET/ROM is to allow use of existing NET/ROM networks,
  4134. this is unlikely.
  4135. .LP
  4136. So it is usually important to avoid AX.25 segmentation when running IP over
  4137. NET/ROM.  The way to do this is to make sure that packets larger
  4138. than \fBpaclen\fP are never handed to AX.25.  A NET/ROM transport header is
  4139. 5 bytes long and a NET/ROM network header takes 15 bytes, so 20 bytes must
  4140. be added to the size of an IP datagram when figuring the size of the AX.25
  4141. I-frame data field. If \fBpaclen\fP is 256, this leaves 236 bytes for the IP
  4142. datagram. This is the default MTU of the \fBnetrom\fP pseudo-interface, so
  4143. as long as \fBpaclen\fP is at least 256 bytes, AX.25 segmentation can't
  4144. happen. But if smaller values of \fBpaclen\fP are used, the \fBnetrom\fP MTU
  4145. must also be reduced with the \fBifconfig\fP command.
  4146. .LP
  4147. On the other hand, if you're running IP directly on top of AX.25, chances
  4148. are all of the nodes are running \fBNos\fP and support AX.25 segmentation.
  4149. In this case there is no reason not to use a larger MTU and let
  4150. AX.25 segmentation do its thing. If you choose
  4151. an MTU on the order of 1000-1500 bytes, you can largely avoid IP-level
  4152. fragmentation and reduce TCP/IP-level header overhead on file transfers
  4153. to a very low level.
  4154. And you are still free to pick whatever \fBpaclen\fP value is
  4155. appropriate for the link.
  4156. .NH 3
  4157. Setting MSS
  4158. .LP
  4159.  
  4160. The setting of this TCP-level parameter is somewhat less critical than the
  4161. IP and AX.25 level parameters already discussed, mainly because it is
  4162. automatically lowered according to the MTU of the local interface when a
  4163. connection is created. Although this is, strictly speaking, a protocol
  4164. layering violation (TCP is not supposed to have any knowledge of the
  4165. workings of lower layers) this technique does work well in practice.
  4166. However, it can be fooled; for example, if a routing change occurs after the
  4167. connection has been opened and the new local interface has a smaller MTU
  4168. than the previous one, IP fragmentation may occur in the local system.
  4169. .LP
  4170. The only drawback to setting a large MSS is that it might cause avoidable
  4171. fragmentation at some other point within the network path if it includes a
  4172. "bottleneck" subnet with an MTU smaller than that of the local interface.
  4173. (Unfortunately, there is presently no way to know when this is the case.
  4174. There is ongoing work within the Internet Engineering Task Force on a "MTU
  4175. Discovery" procedure to determine the largest datagram that may be sent over
  4176. a given path without fragmentation, but it is not yet complete.)
  4177. Also, since the MSS you specify is sent to the remote system, and not all
  4178. other TCPs do the MSS-lowering procedure yet, this might cause the remote
  4179. system to generate IP fragments unnecessarily.
  4180. .LP
  4181. On the other hand, a too-small MSS can result in a considerable performance
  4182. loss, especially when operating over fast LANs and networks that can handle
  4183. larger packets. So the best value for MSS is probably 40 less than the
  4184. largest MTU on your system, with the 40-byte margin allowing for the TCP and
  4185. IP headers. For example, if you have a SLIP interface with a 1006 byte MTU
  4186. and an Ethernet interface with a 1500 byte MTU, set MSS to 1460 bytes. This
  4187. allows you to receive maximum-sized Ethernet packets, assuming the path to
  4188. your system does not have any bottleneck subnets with smaller MTUs.
  4189. .NH 3
  4190. Setting Window
  4191. .LP
  4192. A sliding window protocol like TCP cannot transfer more than one window's
  4193. worth of data per round trip time interval. So this TCP-level parameter
  4194. controls the ability of the remote TCP to keep a long "pipe" full. That is,
  4195. when operating over a path with many hops, offering a large TCP window will
  4196. help keep all those hops busy when you're receiving data. On the other hand,
  4197. offering too large a window can congest the network if it cannot buffer all
  4198. that data. Fortunately, new algorithms for dynamic controlling the
  4199. effective TCP flow control window have been developed over the past few
  4200. years and are now widely deployed.
  4201. \fBNos\fP includes them, and you can watch them
  4202. in action with the \fBtcp status <tcb>\fP or \fBsocket <sockno>\fP commands.
  4203. Look at the \fBcwind\fP (congestion window) value.
  4204. .LP
  4205. In most cases it is safe to set the TCP window to a small integer
  4206. multiple of the MSS, (eg. 4times), or larger if necessary to fully utilize a
  4207. high bandwidth*delay product path. One thing to keep in mind, however, is
  4208. that advertising a certain TCP window value declares that the system has
  4209. that much buffer space available for incoming data.
  4210. \fBNos\fP does not actually preallocate this space;
  4211. it keeps it in a common pool and may well "overbook" it,
  4212. exploiting the fact that many TCP connections are idle for long periods
  4213. and gambling that most applications will read incoming data from an active
  4214. connection as soon as it arrives, thereby quickly freeing the buffer memory.
  4215. However, it is possible to run \fBNos\fP out of memory if excessive TCP window
  4216. sizes are advertised and either the applications go to sleep indefinitely
  4217. (eg. suspended Telnet sessions) or a lot of out-of-sequence data arrives.
  4218. It is wise to keep an eye on the amount of available memory and to decrease
  4219. the TCP window size (or limit the number of simultaneous connections) if it
  4220. gets too low.
  4221. .LP
  4222. Depending on the channel access method and link level protocol, the use
  4223. of a window setting that exceeds the MSS may cause an increase in channel
  4224. collisions. In particular, collisions between data packets and returning
  4225. acknowledgements during a bulk file transfer
  4226. may become common. Although this is, strictly speaking,
  4227. not TCP's fault, it is possible to work around the problem at the TCP level
  4228. by decreasing the window so that the protocol operates in stop-and-wait mode.
  4229. This is done by making the window value equal to the MSS.
  4230. .NH 2
  4231. Summary
  4232. .LP
  4233. In most cases, the default values provided by \fBNos\fP for each of these
  4234. parameters
  4235. will work correctly and give reasonable performance. Only in special
  4236. circumstances such as operation over a very poor link or experimentation
  4237. with high speed modems should it be necessary to change them.
  4238.